Markdown使用指南(轉(zhuǎn)+練習(xí))

一、簡介

什么是Markdown?Markdown是一種輕量級的[標(biāo)記語言],通常為程序員群體所用,目前它已經(jīng)是全球最大的技術(shù)分享網(wǎng)站GitHub和技術(shù)問答網(wǎng)站StackOverFlow的御用書寫格式。

有道云筆記內(nèi)置Markdown編輯器和使用指南,非技術(shù)類筆記用戶,千萬不要被[標(biāo)記]、[語言]嚇到,Markdown的語法十分簡單,常用的標(biāo)記符號不超過十個,用于日常寫作記錄綽綽有余,不到半小時就能完全掌握。

就是這十個不到的標(biāo)記符號,卻能讓人優(yōu)雅地沉浸式記錄,專注內(nèi)容而不是糾結(jié)排版,達到[心中無塵,碼字入神]的境界。

二、利用Markedown可以做什么?

2.1 代碼高亮

image

2.2 制作待辦事項To-do List

image

2.3 高效繪制:流程圖、序列圖、甘特圖、表格

【流程圖】:

image

【序列圖】:

image

【甘特圖】:

image

【表格】:

image

2.4 書寫數(shù)學(xué)公式

image

三、有道云筆記Markdown簡明版使用指南

3.1 標(biāo)題

標(biāo)題是每篇文章必備而且最常用的格式。

在Markdown中,如果想將一段文字定義為標(biāo)題,只需要<font color="912CEE">在這段文字前面加上#,再在#后加一個空格即可</font>。還可增加二、三、四、五、六級標(biāo)題,總共六級,只需要增加#,<font color="912CEE">增加一個#,標(biāo)題字號相應(yīng)降低一級</font>。如圖:

image

3.2 列表

列表格式也很常用,它可以讓你的文稿變得井井有條。在Markedown中,你只需要<font color="912CEE">在文字前面加上-就可以了;如果你希望是有序列表,在文字前面加上1.、2.、3.即可</font>。

注意:1.和文字之間要保留一個字符的空格

image

3.3 引用

如果你需要在文稿中引用一段別處的句子,那么就要用到[引用]格式。<font color="912CEE">在引用文字前加上>并與文字保留一個空格的字符即可</font>。

image

3.4 粗體和斜體

Markdown的粗體和斜體也非常簡單:

<font color="912CEE">用兩個*包含一段文本就是粗體的語法;</font>

<font color="912CEE">用一個*包含一段文本就是斜體的語法。</font>

image

3.5 鏈接與圖片

<font color="912CEE">鏈接:在Markdown中插入鏈接只需要使用[顯示文本](鏈接地址)即可。</font>

<font color="912CEE">圖片:在Markdown中,插入圖片只需要使用![顯示文本](圖片鏈接地址)即可。</font>

注意:插入圖片的語法和鏈接的語法很像,只是前面多了一個!

image

3.6 分割線

分割線的語法只需要<font color="912CEE">另起一行,連續(xù)輸入三個星號***即可</font>分割兩段文字內(nèi)容。如圖:

image

3.7 表格

當(dāng)你需要在Markdown文稿中鍵入表格,代碼如下:

image

【實例參考】:

image

3.8 換行

要想換行,常簡的有如下幾種:

1.在兩段文字中間空一行即可。

2.使用HTML的語法,在文字段末尾增加<br>即可。

注:使用<br>分行間隔是緊挨著的。

3.9 添加代碼段

Markdown插入代碼段的方法:英文輸入法下,輸入一對```(就是鍵盤左上角的~鍵),然后把代碼段黏貼到它們之間,就OK了。

【比如下面的示例】:

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    printf("hello world!\n");
    return 0;
}

3.10 顯示特殊字符(與Markdown語法沖突字符)

特殊字符的顯示可以使用單個'\'來進行顯示。

3.11 修改文本的字體

Markdown內(nèi)嵌HTML語法,可以通過標(biāo)記的方式修改文本的字體。語法如下:

<font face="黑體">這是一串黑體字</font><br>

<font face="華文彩云">這是一串華文彩云</font><br>

【效果如下】:

<font face="黑體">這是一串黑體字</font>

<font face="華文彩云">這是一串華文彩云</font>

3.12 改變字體的顏色和大小

Markdown內(nèi)嵌HTML語法,可以通過標(biāo)記的方式修改字體的顏色和大小。語法如下:

修改字體顏色:<font color="#dd0000">淺紅色文字:</font></br>

修改字體大小:<font size="8">size為8</font><br>

附:RGB顏色查詢對照表

【修改顏色和大小的效果如下】:

淺紅色文字:<font color="#dd0000">淺紅色文字</font></br>
深紅色文字:<font color="#660000">深紅色文字</font></br>
size為3:<font size="3">size為3</font>

size為5:<font size="5">size為5</font>

3.13 總結(jié)

如上前7大格式是寫作文稿時最長使用的。后面幾個是使用中也比較常見的用法。

怎么樣,看了相關(guān)Markdown語法是不是覺得挺簡單?

當(dāng)然,Markedown新手在使用不熟練的情況下,可能會忘記相關(guān)語法,也沒關(guān)系,筆記的工具欄內(nèi)置了Markdown語法,方便學(xué)習(xí)與熟悉。

如,[表格]語法相對復(fù)雜,你可能忘記了,這時候,你只需要點擊編輯框上方工具欄,點選[表格]的圖標(biāo),左邊編輯區(qū)便于出現(xiàn)[表格]相應(yīng)代碼:

image

然后,你只需要將代碼替換成相應(yīng)文本即可,如圖:

image

熟悉語法之后,還是建議大家少使用輔助工具欄,盡量自己鍵入代碼,感受純文本之美。

當(dāng)然,有道云筆記的Markdown還能支持制作待辦事項,書寫流程圖、序列圖、甘特圖,書寫數(shù)學(xué)公式等,是不是夠極客,夠有逼格?

看看筆記菌用Markdown甘特圖寫的項目計劃時間表:

image

四、有道云筆記Markdown進階版使用指南

“進階版”有道云筆記Markdown指南,教你如何進一步掌握代辦、清單、流程圖和甘特圖。

4.1 待辦和清單

待辦事項和清單在日常工作、生活中經(jīng)常被使用。

在Markdown中,你只需要在待辦的事項文本或者清單前加上-[]、-[x]即可。

-[]表示未完成, -[x]表示已完成。

注:鍵入字符與字符之間都要保留一個字符的空格。

【具體呈現(xiàn)如下】:

image

4.2 流程圖

在Markdown中,一段流程圖語法以"`開頭,以"`結(jié)尾。

在"`后另起一行,書寫graph XX,用以確定將要繪制的流程圖及其類型(XX表示流程圖類型)。

流程圖分為豎向和橫向兩大類,豎向包括自上而下和自下而上兩種順序,橫向包括從右到左和從左到右兩種順序。

其對應(yīng)語法分別為:graph TB/graph BT/graph RL/graph LR

  • TB - top bottom (自上而下)
  • BT - bottom top (自下而上)
  • RL - right left (從右到左)
  • LR - left right (從左到右)

【簡單示例如圖】:

image
image
image
image

【來學(xué)習(xí)一個具體案例】:

image

仔細研究上述案例,會發(fā)現(xiàn),我們可以通過調(diào)整語法來調(diào)整流程圖的框線、連接線,不同條件能導(dǎo)向不同的結(jié)果。

①對框線形狀的調(diào)整,如:

image

②對箭頭的調(diào)整,如:

image

只要充分掌握該語法,再復(fù)雜的流程圖也完全能用Markdown書寫!

更詳細的流程圖語法,可參見:http://knsv.github.io/mermaid/#flowcharts-basic-syntax

4.3 甘特圖

我們在工作中用甘特圖做計劃進度表、項目進度表再合適不過了。

以如下甘特圖為例說明:

image

與流程圖一樣,Markdown中,甘特圖的語法也是以"`開頭,以"`結(jié)尾。

在"`后另起一行,書寫gantt,用以確定將要繪制的是甘特圖。

標(biāo)題的書寫語法如下:

image

dataFormat YYYY-MM-DD規(guī)定了時間軸,title(標(biāo)題文本)表示甘特圖標(biāo)題。

如需按項目進行劃分,需鍵入section,空一格字符,再輸入項目名稱的文本(一個section和另一個section之間要空行)。

每個大項目將拆解為若干個小任務(wù),只需在section之后另起一行,直接輸入小項目名稱即可。

更詳細的甘特圖語法,參見http://knsv.github.io/mermaid/#styling39

五、Tips for有道云筆記中的Markdown

5.1 實時同步預(yù)覽,所看即所得

我們將筆記編輯界面一分為二,左邊為編輯區(qū),右邊為預(yù)覽區(qū),兩區(qū)滾動條同步。在編輯區(qū)的操作能夠?qū)崟r反映在瀏覽區(qū),方便及時調(diào)整和查看最終版面效果。

5.2 工具欄內(nèi)置Markdown語法,方便新手學(xué)習(xí)

編輯頁面頂端的工具欄有對應(yīng)代碼,如果你是一個不熟悉Markdown語法的新手,可以先嘗試用工具欄輔助操作。也可以在網(wǎng)上搜索[Markdown語法指南]進行學(xué)習(xí)。

當(dāng)然,如果你覺得工具欄太打擾,點擊下方分界條即可隱藏工具欄,切換到極簡編輯環(huán)境。

5.3實時云端保存

Markdown模式繼承了有道云筆記的優(yōu)良傳統(tǒng),你每一次擊鍵的內(nèi)容都會實時保存在云端,無需擔(dān)心瀏覽器崩潰、設(shè)備沒電、突然斷網(wǎng)等情況。對于寫作者來說,更是再也不用擔(dān)心因為各種原因痛失文稿的情況了。

5.4 界面大小可點擊分解條調(diào)整

點擊“1”處,工具欄收起;點擊“2”處,右側(cè)預(yù)覽區(qū)收起。

image

【點擊后燈效果】:

image

六、Markdown其他技巧

6.1 改變背景顏色(未驗證成功)

修改文字的背景顏色方法為:

<table><tr><td bgcolor=#ff00ff>背景色是:#ff00ff</td></tr></table>

附:RGB顏色查詢對照表

【效果如下】:

<table><tr><td bgcolor=#ff00ff>背景色是:#ff00ff</td></tr></table>

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容