概述
宗旨
Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」爽撒。
可讀性,無論如何,都是最重要的始赎。一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文本發(fā)布,并且看起來不會像是由許多標(biāo)簽或是格式指令所構(gòu)成。Markdown 語法受到一些既有 text-to-HTML 格式的影響造垛,而最大靈感來源其實(shí)是純文本電子郵件的格式魔招。
總之, Markdown 的語法全由一些符號所組成筋搏,這些符號經(jīng)過精挑細(xì)選仆百,其作用一目了然。比如:在文字兩旁加上星號奔脐,看起來就像強(qiáng)調(diào)俄周。Markdown 的列表看起來,嗯髓迎,就是列表峦朗。Markdown 的區(qū)塊引用看起來就真的像是引用一段文字,就像你曾在電子郵件中見過的那樣排龄。
語法指南
標(biāo)題
在 Markdown 中波势,你只需要在文本前面加上 # 即可,同理橄维、你還可以增加二級標(biāo)題尺铣、三級標(biāo)題、四級標(biāo)題争舞、五級標(biāo)題和六級標(biāo)題凛忿,總共六級,只需要增加 # 即可竞川,標(biāo)題字號相應(yīng)降低店溢。例如:
# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題
注:# 和「一級標(biāo)題」之間保留一個字符的空格
列表
在 Markdown 中,你只需要在文字前面加上 - 就可以了委乌,例如:
- 文本1
- 文本2
- 文本3
引用
在我們寫作的時候經(jīng)常需要引用他人的文字床牧,這個時候引用這個格式就很有必要了,在 Markdown 中遭贸,在引用的文字前面加上 > 戈咳,例如:
> 我是要被引用的內(nèi)容
注:> 和文本之間要保留一個字符的空格。
斜體
用一個 * 包含一段文本就是斜體的語法壕吹。例如:
*斜體*
表格
| 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 |
最終效果
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
代碼引用
code between
顯示圖片和鏈接
在 Markdown 中著蛙,插入鏈接不需要其他按鈕,例如:
[baidu](https://baidu.com)
在 Markdown 中算利,插入圖片不需要其他按鈕,你只需要使用 這樣的語法即可泳姐,例如:
![image](http://upload-images.jianshu.io/upload_images/11710736-db675347d71322ea.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
注:插入圖片的語法和鏈接的語法很像效拭,只是前面多了一個 !。