Markdown 的語法全由一些符號所組成玻褪,這些符號經(jīng)過精挑細選亏推,其作用一目了然呻顽。
一個 Markdown 段落是由一個或多個連續(xù)的文本行組成茧痕,它的前后要有一個以上的空行(空行的定義是顯示上看起來像是空的,便會被視為空行截汪。比方說疾牲,若某一行只包含空格和制表符,則該行也會被視為空行)衙解。普通段落不該用空格或制表符來縮進阳柔。
標題
在文本前加上#
即可,一級標題使用一個#
蚓峦,二級標題使用兩個#
舌剂,以此類推。
區(qū)塊引用
在文本前加上>
暑椰,文本前要保留一個空格霍转。
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
也允許只在整個段落的第一行最前面加上>
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
上面兩種方式的顯示效果均如下:
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
區(qū)塊應用可以嵌套,只要根據(jù)層次加上不同數(shù)量 的>
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
效果如下:
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
列表
在列表前加上-
一汽,為無序的避消。也可使用+
或者*
在列表前加上1.
2.
3.
,是有序的召夹。即數(shù)字接英語句點岩喷。
列表項目標記通常是放在最左邊,但是其實也可以縮進监憎,最多 3 個空格纱意,項目標記后面則一定要接著至少一個空格或制表符。
列表項目可以包含多個段落鲸阔,每個項目下的段落都必須縮進 4 個空格或是 1 個制表符妇穴。
如果要在列表項目內(nèi)放進引用,那 > 就需要縮進:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
如果要放代碼區(qū)塊的話隶债,該區(qū)塊就需要縮進兩次,也就是 8 個空格或是 2 個制表符:
* 一列表項包含一個列表區(qū)塊:
<代碼寫在這>
分隔線
三個以上的星號***
跑筝、減號---
死讹、底線___
來建立一個分隔線,行內(nèi)不能有其他東西曲梗。也可以在星號或是減號中間插入空格赞警。
鏈接
支持兩種形式的鏈接語法: 行內(nèi)式和參考式兩種形式。
- 行內(nèi)式
[顯示文本](鏈接地址)
- 參考式
[顯示文本][id]
在第二個方括號里面填入用以辨識鏈接的標記虏两,接著愧旦,在文件的任意處,可以把這個標記的鏈接內(nèi)容定義出來:[id]: 鏈接地址
鏈接內(nèi)容定義的形式為:- 方括號(前面可以選擇性地加上至多三個空格來縮進)定罢,里面輸入鏈接文字
接著一個冒號 - 接著一個以上的空格或制表符
- 接著鏈接的網(wǎng)址
- 選擇性地接著 title 內(nèi)容笤虫,可以用單引號、雙引號或是括弧包著
- 方括號(前面可以選擇性地加上至多三個空格來縮進)定罢,里面輸入鏈接文字
圖片
同樣也允許兩種樣式: 行內(nèi)式和參考式。
- 行內(nèi)式

- 參考式
琼蚯![][id]
id是圖片參考的名稱酬凳,圖片參考的定義方式和鏈接參考一樣。
Markdown只能以鏈接形式插入圖片遭庶。
代碼引用
如果引用的語句只有一段宁仔,不分行,用\
置于語句前后峦睡。 如果引用的語句為多行翎苫,可以將
``` `置于這段代碼的首行和末行。
粗體和斜體
粗體:用兩個*
或者_
包含文字
斜體:用一個*
或者_
包含文字
表格
相關代碼:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
顯示效果:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
自動鏈接
Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱榨了,只要是用尖括號包起來煎谍, Markdown 就會自動把它轉(zhuǎn)成鏈接。一般網(wǎng)址的鏈接文字就和鏈接地址一樣阻逮,例如:
<http://example.com/>
效果如下:
http://example.com/
反斜杠
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚嘆號