更新時(shí)間: 2017-03-29 17:23
當(dāng)前版本: v0.0.2
1 標(biāo)題
標(biāo)題是每篇文章都有父款,也是最常用的格式溢谤。在Markdown語(yǔ)法中,標(biāo)題使用井號(hào)(#
)開(kāi)頭铛漓,獨(dú)占一行溯香,后面添加一個(gè)空格分隔,之后的內(nèi)容即為標(biāo)題文本浓恶。
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
...
以此類(lèi)推玫坛,總共支持6級(jí)標(biāo)題。
段落和換行
一個(gè)Markdown段落是由一個(gè)或多個(gè)連續(xù)的文本行組成包晰,它的前后要有一個(gè)以上的空行湿镀。
2 列表
在Markdown中,列表的顯示只需要在文字前加上減號(hào)(-
)或者星號(hào)(*
)即可變?yōu)?strong>無(wú)序列表伐憾;如果在文字之前直接加上(數(shù)字+點(diǎn))勉痴,例如1.
、2.
树肃、3.
等蒸矛。
注意:符號(hào)和列表文字之間也需要加上一個(gè)空格分割。
3 引用
如果你需要引用一小段別處的句子,那么可以使用引用格式雏掠。在Markdown中斩祭,只需要在段落的第一行最前面加上大于號(hào)(>
),后面跟上你需要引用的文本即可乡话,格式如下:
> 日出江花紅勝火摧玫,春來(lái)江水綠如藍(lán)。
顯示效果如下:
日出江花紅勝火绑青,春來(lái)江水綠如藍(lán)诬像。
問(wèn)題:如何在引用的內(nèi)容中使用換行?
方法:在上一行文本的末尾添加兩個(gè)空格再回車(chē)闸婴。
嵌套引用
引用是可以嵌套的坏挠,只需要根據(jù)層次加上不同數(shù)量的大于號(hào)(>
),例如:
> 這是第一層引用開(kāi)頭
> >這是第二層引用開(kāi)頭
>
> 這是第一層引用結(jié)尾
運(yùn)行效果如下:
這是第一層引用開(kāi)頭
這是第二層引用開(kāi)頭
這是第一層引用結(jié)尾
4 圖片與鏈接
插入圖片和插入鏈接的語(yǔ)法格式非常相似掠拳,區(qū)別在于插入圖片時(shí)開(kāi)頭多了一個(gè)感嘆號(hào)(!
)癞揉。
插入圖片
![](image_url)
注意:插入圖片地址時(shí)需要圖床,也就是需要一個(gè)存放圖片的位置溺欧,并生成對(duì)應(yīng)的URL喊熟。
插入鏈接
[link_display_name](link_url)
5 粗體和斜體
在Markdown中,可以使用文本前后各兩個(gè)星號(hào)(*
)或者下劃線(xiàn)(_
)來(lái)粗體表示星號(hào)中間的文字姐刁;使用文本前后各一個(gè)星號(hào)來(lái)斜體表示星號(hào)中間的文字芥牌。格式如下:
** 這是粗體 **
* 這是斜體 *
6 表格
在Markdown語(yǔ)法中,表示表格十分麻煩聂使,示例如下:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
其中壁拉,第一行用于設(shè)置表格的頭部,列與列之間使用單豎線(xiàn)(|
)分隔柏靶。第二行用于設(shè)置每一列的對(duì)齊方式弃理,默認(rèn)為左對(duì)齊,如果短橫線(xiàn)兩邊各有一個(gè)冒號(hào)(:
)就是居中對(duì)齊屎蜓;否則痘昌,哪邊有,就跟哪邊對(duì)齊炬转。效果如下:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
7 代碼框
對(duì)于程序員而言辆苔,經(jīng)常需要在文章中引用一段代碼,這個(gè)時(shí)候就需要使用到代碼框扼劈。在Markdown中驻啤,只需要使用前后各3個(gè)反引號(hào)(```)把代碼片段包裹在中間即可。如果需要引用的代碼只有一行荐吵,那么可以使用前后各1個(gè)反引號(hào)(`)把代碼包裹起來(lái)骑冗。
```
import math
print math.PI
```
以上代碼的運(yùn)行效果如下:
import math
print math.PI
注意:可以使用TAB
鍵進(jìn)行縮進(jìn)赊瞬。
8 分割線(xiàn)
在Markdown中,三個(gè)連續(xù)的星號(hào)(*
)可以生成一根分割線(xiàn)沐旨。運(yùn)行效果如下:
9 反斜杠
Markdown可以利用反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào)森逮,例如:如果你想要用星號(hào)加在文字旁邊的方式來(lái)做出強(qiáng)調(diào)效果,你可以在星號(hào)的前面加上反斜杠:
\*不使用斜體磁携,僅僅在兩端使用星號(hào)強(qiáng)調(diào)*
*不使用斜體,僅僅在兩端使用星號(hào)強(qiáng)調(diào)*