基本語(yǔ)法
段落
- 段落由一個(gè)或多個(gè)連續(xù)的文本行組成克握,它的前后要有一個(gè)以上的空行。
- 若某一行只包含空格和制表符,則也會(huì)被視為空行坤次。
- 段落內(nèi)的強(qiáng)迫換行(插入換行符),在插入處先按入兩個(gè)以上的空格然后回車斥赋。
標(biāo)題
- 在行首插入 1 到 6 個(gè)井號(hào)
#
缰猴,對(duì)應(yīng)到標(biāo)題 1 到 6 階。
強(qiáng)調(diào)
- 星號(hào)
*
或底線_
包起來的內(nèi)容變?yōu)樾斌w - 兩個(gè)星號(hào)
**
或底線__
包起來的內(nèi)容變?yōu)榇煮w - 強(qiáng)調(diào)可以直接插在文字中間
區(qū)塊引用
- 在每行的最前面加上大于號(hào)
>
- 也可以偷懶只在整個(gè)段落的第一行最前面加上
>
- 嵌套區(qū)塊引用只需要根據(jù)層次加上不同數(shù)量的
>>
等
小段行內(nèi)代碼
- 要標(biāo)記一小段行內(nèi)代碼疤剑,你可以用反引號(hào)
`
把它包起來 - 要插入反引號(hào)滑绒,可以用多個(gè)反引號(hào)來開啟和結(jié)束代碼區(qū)段
代碼區(qū)塊
- 推薦方法闷堡,在區(qū)塊行首和區(qū)塊尾加上三個(gè)反引號(hào)
(```)
- 開頭加上一個(gè)縮進(jìn)(4 個(gè)空格或是 1 個(gè)制表符),建立代碼區(qū)塊
- 在列表中插入時(shí)要兩個(gè)縮進(jìn)
- 代碼區(qū)塊會(huì)一直持續(xù)到?jīng)]有縮進(jìn)的那一行(或是文件結(jié)尾)
列表
- 無序列表使用星號(hào)
*
疑故、減號(hào)-
或是加號(hào)+
作為列表標(biāo)記 - 有序列表使用數(shù)字接著一個(gè)英文句點(diǎn)
1.
- 在行首出現(xiàn)數(shù)字-句點(diǎn)-空白時(shí)杠览,在句點(diǎn)前面加上反斜杠
2017\.
- 列表可以包含多個(gè)段落,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符
- 如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)引用纵势,那
>
的前面就需要縮進(jìn) - 如果要放代碼區(qū)塊倦零,該區(qū)塊就需要縮進(jìn)兩次
分隔線
- 在一行中用三個(gè)以上的星號(hào)
*
、減號(hào)-
吨悍、底線_
來建立一條分隔線 - 行內(nèi)不能有其他東西扫茅。但可以在符號(hào)中間插入空格
插入鏈接
行內(nèi)式的鏈接
- 方塊括號(hào)后面緊接著圓括號(hào):
[顯示文字](鏈接地址)
- 如果需要鏈接的 title 文字,在鏈接地址后面育瓜,加空格再用雙引號(hào)把 title 文字包起來葫隙。如:
[an example](http://example.com/ "Title")
- 如果是鏈接到同樣主機(jī)的資源,可以使用相對(duì)路徑
參考式的鏈接
- 在鏈接文字的方括號(hào)后再接上另一個(gè)方括號(hào)躏仇,其中填入鏈接的標(biāo)記:
[an examp][id]
- 然后恋脚,可以在文件的任意處,把該標(biāo)記的鏈接內(nèi)容定義出來:
[id]:http://example.com/ "Optional Title Here"
- 鏈接內(nèi)容定義的形式為:
- 方括號(hào)(前面可選擇加上最多三個(gè)空格來縮進(jìn))焰手,里面輸入鏈接標(biāo)記
- 接著一個(gè)冒號(hào)糟描,接著一個(gè)以上的空格或制表符
- 接著鏈接的網(wǎng)址,接著一個(gè)以上的空格或制表符
- 可選接著 title 內(nèi)容书妻,可以用雙引號(hào)包著
- 鏈接標(biāo)記可以有字母船响、數(shù)字、空白和標(biāo)點(diǎn)符號(hào)躲履,但是不區(qū)別大小寫
插入圖片
- 類似插入鏈接,分為行內(nèi)式和參考式
- 區(qū)別是在插入時(shí),前面加上感嘆號(hào)
!
- 參考式定義標(biāo)記的鏈接內(nèi)容時(shí)不需要感嘆號(hào)
其他
自動(dòng)鏈接
- 直接用尖括號(hào)包起來见间, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接:
<http://example.com/>
反斜杠
- 可以利用反斜杠來插入一些在語(yǔ)法中有其它意義的符號(hào):
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)