Markdown 語法手冊（完整整理版）

imelee 2016-12-21

展開全文

0. 目錄

1. 斜體和粗體

代碼：

*斜體*或_斜體_
**粗體**
***加粗斜體***
~~刪除線~~

顯示效果：

這是一段斜體
這是一段粗體
這是一段加粗斜體
~~這是一段刪除線~~

2. 分級標(biāo)題

第一種寫法：

這是一個一級標(biāo)題
============================
這是一個二級標(biāo)題
--------------------------------------------------

第二種寫法：

# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題

由于用了[TOC]標(biāo)記編輯器會把所有標(biāo)題寫到目錄大綱中，在這里寫的演示標(biāo)題也會列進去，所以就不演示了。同學(xué)們自己在編輯器中觀察，很簡單，一級標(biāo)題字號最大，依級遞減。

3. 超鏈接

Markdown 支持兩種形式的鏈接語法：行內(nèi)式和參考式兩種形式，行內(nèi)式一般使用較多。

3.1. 行內(nèi)式

語法說明：

[]里寫鏈接文字，()里寫鏈接地址, ()中的”“中可以為鏈接指定title屬性，title屬性可加可不加。title屬性的效果是鼠標(biāo)懸停在鏈接上會出現(xiàn)指定的 title文字。[鏈接文字](鏈接地址 “鏈接標(biāo)題”)’這樣的形式。鏈接地址與鏈接標(biāo)題前有一個空格。

代碼：

歡迎來到[梵居鬧市](http://blog./freewalk)
歡迎來到[梵居鬧市](http://blog./freewalk "梵居鬧市")

顯示效果：

歡迎來到梵居鬧市

3.2. 參考式

參考式超鏈接一般用在學(xué)術(shù)論文上面，或者另一種情況，如果某一個鏈接在文章中多處使用，那么使用引用的方式創(chuàng)建鏈接將非常好，它可以讓你對鏈接進行統(tǒng)一的管理。

語法說明：
參考式鏈接分為兩部分，文中的寫法 [鏈接文字][鏈接標(biāo)記]，在文本的任意位置添加[鏈接標(biāo)記]:鏈接地址 “鏈接標(biāo)題”，鏈接地址與鏈接標(biāo)題前有一個空格。

如果鏈接文字本身可以做為鏈接標(biāo)記，你也可以寫成[鏈接文字][]
[鏈接文字]：鏈接地址的形式，見代碼的最后一行。

代碼：

我經(jīng)常去的幾個網(wǎng)站[Google][1]、[Leanote][2]以及[自己的博客][3]
[Leanote 筆記][2]是一個不錯的[網(wǎng)站][]。
[1]:http://www.google.com "Google"
[2]:http://www. "Leanote"
[3]:http://http://blog./freewalk "梵居鬧市"
[網(wǎng)站]:http://http://blog./freewalk

顯示效果：

我經(jīng)常去的幾個網(wǎng)站Google、Leanote以及自己的博客
 Leanote 筆記是一個不錯的網(wǎng)站。

3.3. 自動鏈接

語法說明：
Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱，只要是用<>包起來， Markdown 就會自動把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣，例如：

代碼：

<http:///>
<address@>

顯示效果：

http:///
address@

4. 錨點

網(wǎng)頁中，錨點其實就是頁內(nèi)超鏈接，也就是鏈接本文檔內(nèi)部的某些元素，實現(xiàn)當(dāng)前頁面中的跳轉(zhuǎn)。比如我這里寫下一個錨點，點擊回到目錄，就能跳轉(zhuǎn)到目錄。在目錄中點擊這一節(jié)，就能跳過來。還有下一節(jié)的注腳。這些根本上都是用錨點來實現(xiàn)的。

注意：
1. Markdown Extra 只支持在標(biāo)題后插入錨點，其它地方無效。
2. Leanote 編輯器右側(cè)顯示效果區(qū)域暫時不支持錨點跳轉(zhuǎn)，所以點來點去發(fā)現(xiàn)沒有跳轉(zhuǎn)不必驚慌，但是你發(fā)布成筆記或博文后是支持跳轉(zhuǎn)的。

語法描述：
在你準(zhǔn)備跳轉(zhuǎn)到的指定標(biāo)題后插入錨點{#標(biāo)記}，然后在文檔的其它地方寫上連接到錨點的鏈接。

代碼：

## 0. 目錄{#index}
跳轉(zhuǎn)到[目錄](#index)

顯示效果：

跳轉(zhuǎn)到目錄

5. 列表

5.1. 無序列表

使用 *，+，- 表示無序列表。

代碼：

- 無序列表項 一
- 無序列表項 二
- 無序列表項 三

顯示效果：

無序列表項一
無序列表項二
無序列表項三

5.2. 有序列表

有序列表則使用數(shù)字接著一個英文句點。

代碼：

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三

顯示效果：

有序列表項一
有序列表項二
有序列表項三

5.3. 定義型列表

語法說明：

定義型列表由名詞和解釋組成。一行寫上定義，緊跟一行寫上解釋。解釋的寫法:緊跟一個縮進(Tab)

代碼：

Markdown
:    輕量級文本標(biāo)記語言，可以轉(zhuǎn)換成html，pdf等格式（左側(cè)有一個可見的冒號和四個不可見的空格）
代碼塊 2
:   這是代碼塊的定義（左側(cè)有一個可見的冒號和四個不可見的空格）
        代碼塊（左側(cè)有八個不可見的空格）

顯示效果：

Markdown

輕量級文本標(biāo)記語言，可以轉(zhuǎn)換成html，pdf等格式

代碼塊 2

這是代碼塊的定義

代碼塊（左側(cè)有八個不可見的空格）

5.3. 列表縮進

語法說明：

列表項目標(biāo)記通常是放在最左邊，但是其實也可以縮進，最多 3 個空格，項目標(biāo)記后面則一定要接著至少一個空格或制表符。

要讓列表看起來更漂亮，你可以把內(nèi)容用固定的縮進整理好（顯示效果與代碼一致）：

輕輕的我走了，正如我輕輕的來；我輕輕的招手，作別西天的云彩。
那河畔的金柳，是夕陽中的新娘；波光里的艷影，在我的心頭蕩漾。
軟泥上的青荇，油油的在水底招搖；在康河的柔波里，我甘心做一條水草！
那榆蔭下的一潭，不是清泉，是天上虹；揉碎在浮藻間，沉淀著彩虹似的夢。
尋夢？撐一支長篙，向青草更青處漫溯；滿載一船星輝，在星輝斑斕里放歌。
但我不能放歌，悄悄是別離的笙簫；夏蟲也為我沉默，沉默是今晚的康橋！
悄悄的我走了，正如我悄悄的來；我揮一揮衣袖，不帶走一片云彩。

但是如果你懶，那也行：
代碼：

*   輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。 
軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！ 
*   那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。 
尋夢？撐一支長篙， 向青草更青處漫溯； 滿載一船星輝， 在星輝斑斕里放歌。 
但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！ 
悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

顯示效果：

輕輕的我走了，正如我輕輕的來；我輕輕的招手，作別西天的云彩。
那河畔的金柳，是夕陽中的新娘；波光里的艷影，在我的心頭蕩漾。
軟泥上的青荇，油油的在水底招搖；在康河的柔波里，我甘心做一條水草！
那榆蔭下的一潭，不是清泉，是天上虹；揉碎在浮藻間，沉淀著彩虹似的夢。
尋夢？撐一支長篙，向青草更青處漫溯；滿載一船星輝，在星輝斑斕里放歌。
但我不能放歌，悄悄是別離的笙簫；夏蟲也為我沉默，沉默是今晚的康橋！
悄悄的我走了，正如我悄悄的來；我揮一揮衣袖，不帶走一片云彩。

5.4. 包含段落的列表

語法說明：

列表項目可以包含多個段落，每個項目下的段落都必須縮進 4 個空格或是 1 個制表符（顯示效果與代碼一致）：

輕輕的我走了，正如我輕輕的來；我輕輕的招手，作別西天的云彩。
那河畔的金柳，是夕陽中的新娘；波光里的艷影，在我的心頭蕩漾。
軟泥上的青荇，油油的在水底招搖；在康河的柔波里，我甘心做一條水草！

那榆蔭下的一潭，不是清泉，是天上虹；揉碎在浮藻間，沉淀著彩虹似的夢。
尋夢？撐一支長篙，向青草更青處漫溯；滿載一船星輝，在星輝斑斕里放歌。
但我不能放歌，悄悄是別離的笙簫；夏蟲也為我沉默，沉默是今晚的康橋！
悄悄的我走了，正如我悄悄的來；我揮一揮衣袖，不帶走一片云彩。

如果你每行都有縮進，看起來會看好很多，當(dāng)然，再次地，如果你很懶惰，Markdown 也允許：

代碼：

*   輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。 
軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！
     那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。 
尋夢？撐一支長篙， 向青草更青處漫溯； 滿載一船星輝， 在星輝斑斕里放歌。 
但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！ 
*    悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

顯示效果：

輕輕的我走了，正如我輕輕的來；我輕輕的招手，作別西天的云彩。
那河畔的金柳，是夕陽中的新娘；波光里的艷影，在我的心頭蕩漾。
軟泥上的青荇，油油的在水底招搖；在康河的柔波里，我甘心做一條水草！

那榆蔭下的一潭，不是清泉，是天上虹；揉碎在浮藻間，沉淀著彩虹似的夢。
尋夢？撐一支長篙，向青草更青處漫溯；滿載一船星輝，在星輝斑斕里放歌。
但我不能放歌，悄悄是別離的笙簫；夏蟲也為我沉默，沉默是今晚的康橋！
悄悄的我走了，正如我悄悄的來；我揮一揮衣袖，不帶走一片云彩。

5.5. 包含引用的列表

語法說明：

如果要在列表項目內(nèi)放進引用，那 > 就需要縮進：

代碼：

*   閱讀的方法:
    > 打開書本。
    > 打開電燈。

顯示效果：

閱讀的方法:

打開書本。
打開電燈。

5.6. 包含代碼區(qū)塊的引用

語法說明：
如果要放代碼區(qū)塊的話，該區(qū)塊就需要縮進兩次，也就是 8 個空格或是 2 個制表符：

一列表項包含一個列表區(qū)塊：
```
<代碼寫在這>
```

5.7. 一個特殊情況

在特殊情況下，項目列表很可能會不小心產(chǎn)生，像是下面這樣的寫法：

1986. What a great season.

會顯示成：

What a great season.

換句話說，也就是在行首出現(xiàn)數(shù)字-句點-空白，要避免這樣的狀況，你可以在句點前面加上反斜杠：

1986\. What a great season.

會顯示成：

1986. What a great season.

6. 引用

語法說明：

引用需要在被引用的文本前加上>符號。

代碼：

> 這是一個有兩段文字的引用,
> 無意義的占行文字1.
> 無意義的占行文字2.
> 
> 無意義的占行文字3.
> 無意義的占行文字4.

顯示效果：

這是一個有兩段文字的引用,
無意義的占行文字1.
無意義的占行文字2.

無意義的占行文字3.
無意義的占行文字4.

Markdown 也允許你偷懶只在整個段落的第一行最前面加上 > ：

代碼：

> 這是一個有兩段文字的引用,
無意義的占行文字1.
無意義的占行文字2.
> 無意義的占行文字3.
無意義的占行文字4.

顯示效果：

這是一個有兩段文字的引用,
無意義的占行文字1.
無意義的占行文字2.

無意義的占行文字3.
無意義的占行文字4.

6.1. 引用的多層嵌套

區(qū)塊引用可以嵌套（例如：引用內(nèi)的引用），只要根據(jù)層次加上不同數(shù)量的 > ：

代碼：

>>> 請問 Markdwon 怎么用？ - 小白
>> 自己看教程！ - 憤青
> 教程在哪？ - 小白

顯示效果：

請問 Markdwon 怎么用？ - 小白

自己看教程！ - 憤青

教程在哪？ - 小白

6.2. 引用其它要素

引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法，包括標(biāo)題、列表、代碼區(qū)塊等：

代碼：

> 1.   這是第一行列表項。
> 2.   這是第二行列表項。
> 
> 給出一些例子代碼：
> 
>     return shell_exec("echo $input | $markdown_script");

顯示效果：

這是第一行列表項。

這是第二行列表項。

給出一些例子代碼：
return shell_exec("echo $input | $markdown_script");

7. 插入圖像

圖片的創(chuàng)建方式與超鏈接相似，而且和超鏈接一樣也有兩種寫法，行內(nèi)式和參考式寫法。

語法中圖片Alt的意思是如果圖片因為某些原因不能顯示，就用定義的圖片Alt文字來代替圖片。圖片Title則和鏈接中的Title一樣，表示鼠標(biāo)懸停與圖片上時出現(xiàn)的文字。 Alt 和 Title 都不是必須的，可以省略，但建議寫上。

7.1. 行內(nèi)式

語法說明：![圖片Alt](圖片地址 “圖片Title”)

代碼：

美麗花兒： 
![美麗花兒](http://image102.360doc.com/DownloadImg/2016/12/2102/87417504_1.jpg "美麗花兒")

顯示效果：

美麗花兒：

7.2. 參考式

語法說明：

在文檔要插入圖片的地方寫![圖片Alt][標(biāo)記]

在文檔的最后寫上[標(biāo)記]:圖片地址 “Title”

代碼：

美麗花兒：
![美麗花兒][flower]
[flower]:http://image102.360doc.com/DownloadImg/2016/12/2102/87417504_1.jpg  "美麗花兒"

顯示效果：

美麗花兒：

8. 內(nèi)容目錄

在段落中填寫 [TOC] 以顯示全文內(nèi)容的目錄結(jié)構(gòu)。

效果參見最上方的目錄

9. 注腳

語法說明：

在需要添加注腳的文字后加上腳注名字[^注腳名字],稱為加注。然后在文本的任意位置(一般在最后)添加腳注，腳注前必須有對應(yīng)的腳注名字。

注意：經(jīng)測試注腳與注腳之間必須空一行，不然會失效。成功后會發(fā)現(xiàn)，即使你沒有把注腳寫在文末，經(jīng)Markdown轉(zhuǎn)換后，也會自動歸類到文章的最后。

代碼：

使用 Markdown[^1]可以效率的書寫文檔, 直接轉(zhuǎn)換成 HTML[^2], 你可以使用 Leanote[^Le] 編輯器進行書寫。
[^1]:Markdown是一種純文本標(biāo)記語言
[^2]:HyperText Markup Language 超文本標(biāo)記語言
[^Le]:開源筆記平臺，支持Markdown和筆記直接發(fā)為博文

顯示效果：

使用 Markdown1可以效率的書寫文檔, 直接轉(zhuǎn)換成 HTML2, 你可以使用 Leanote3 編輯器進行書寫。

注：腳注自動被搬運到最后面，請到文章末尾查看，并且腳注后方的鏈接可以直接跳轉(zhuǎn)回到加注的地方。

10. LaTeX 公式

10.1. $ 表示行內(nèi)公式：

代碼：

質(zhì)能守恒方程可以用一個很簡潔的方程式 $E=mc^2$ 來表達。

顯示效果：

質(zhì)能守恒方程可以用一個很簡潔的方程式 $E = m c^{2}$ 來表達。

10.2 $$ 表示整行公式：

代碼：

$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

顯示效果：

\sum_{i = 1}^{n} a_{i} = 0

f (x_{1}, x_{x}, \dots, x_{n}) = x_{1}^{2} + x_{2}^{2} + \dots + x_{n}^{2}

\sum_{k = 0}^{j - 1} {\hat{γ}}_{k j} z_{k}

訪問 MathJax 參考更多使用方法。

11. 流程圖

代碼：

flow
st=>start: Start:>https://www.
io=>inputoutput: verification
op=>operation: Your Operation
cond=>condition: Yes or No?
sub=>subroutine: Your Subroutine
e=>end
st->io->op->cond
cond(yes)->e
cond(no)->sub->io

顯示效果：

更多語法參考：流程圖語法參考

12 .表格

語法說明：

不管是哪種方式，第一行為表頭，第二行分隔表頭和主體部分，第三行開始每一行為一個表格行。
列于列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符。
第二行還可以為不同的列指定對齊方向。默認為左對齊，在-右邊加上:就右對齊。

代碼：

簡單方式寫表格：

學(xué)號|姓名|分數(shù)
-|-|-
小明|男|75
小紅|女|79
小陸|男|92

原生方式寫表格：

|學(xué)號|姓名|分數(shù)|
|-|-|-|
|小明|男|75|
|小紅|女|79|
|小陸|男|92|

為表格第二列指定方向：

產(chǎn)品|價格
-|-:
Leanote 高級賬號|60元/年
Leanote 超級賬號|120元/年

顯示效果：
簡單方式寫表格：

學(xué)號	姓名	分數(shù)
小明	男	75
小紅	女	79
小陸	男	92

原生方式寫表格：

學(xué)號	姓名	分數(shù)
小明	男	75
小紅	女	79
小陸	男	92

為表格第二列指定方向：

產(chǎn)品	價格
Leanote 高級賬號	60元/年
Leanote 超級賬號	120元/年

13. 分隔線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內(nèi)不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線：

代碼：

* * *
***
*****
- - -
---------------------------------------

顯示效果都一樣：

14. 代碼

對于程序員來說這個功能是必不可少的，插入程序代碼的方式有兩種，一種是利用縮進(Tab), 另一種是利用”`”符號（一般在ESC鍵下方）包裹代碼。

語法說明：

插入行內(nèi)代碼，即插入一個單詞或者一句代碼的情況，使用`code`這樣的形式插入。
插入多行代碼，可以使用縮進或者“` code “`,具體看示例。

注意：縮進式插入前方必須有空行

8.1. 行內(nèi)式

代碼：

C語言里的函數(shù) `scanf()` 怎么使用？

顯示效果：

C語言里的函數(shù) scanf() 怎么使用？

8.2. 縮進式多行代碼

縮進 4 個空格或是 1 個制表符

一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行（或是文件結(jié)尾）。

代碼：

    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

顯示效果：

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

8.3. 用六個`包裹多行代碼

代碼：

```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
、、、

顯示效果：

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

8.4. HTML 原始碼

在代碼區(qū)塊里面， & 、 < 和 > 會自動轉(zhuǎn)成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼，只需要復(fù)制貼上，剩下的 Markdown 都會幫你處理，例如：

代碼：

第一個例子：

<div class="footer">
    2004 Foo Corporation
</div>

第二個例子：

<table>
    <tr>
        <th rowspan="2">值班人員</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李強</td>
        <td>張明</td>
        <td>王平</td>
    </tr>
</table>