標(biāo)題
- setext形式即用底線形式：
最高級標(biāo)題（=），二級標(biāo)題（-）任何數(shù)量的‘=’和‘-’效果一樣。
這是一級標(biāo)題 ========
展示方式：
這是一級標(biāo)題
=======
- atx形式：
在行首插入1~6個(gè)'#'，分別對應(yīng)1~6級標(biāo)題（行尾的‘#’與效果無關(guān)）。
# 這是一級標(biāo)題 #
展示方式：這是一級標(biāo)題
區(qū)塊引言
- 在MD文件中建立一個(gè)區(qū)塊引言，看起來像是強(qiáng)迫斷行，然后在每行最前面加‘>’,并且可循環(huán)套用。:
> 區(qū)塊引言文本1
> > 子區(qū)塊引言文本2
展示方式：區(qū)塊引言文本1
子區(qū)塊引言文本2
- 區(qū)塊引言也允許在整個(gè)段落的第一行最前面加上‘>’:
> 這是個(gè)段落 段落中的詳細(xì)文本。 blablabla。
展示方式:這是個(gè)段落
段落中的詳細(xì)文本。
blablabla。
- 區(qū)塊引言中亦可使用其它MD語法，包括標(biāo)題、清單、程式等：
> ## 二級標(biāo)題
>
> 1. 有序列表1.
> 2. 有序列表2
>
> 代碼實(shí)例：
>
> return shell_exec("echo $input | $markdown_script");
** 展示方式： **
二級標(biāo)題
- 有序列表1.
- 有序列表2
代碼實(shí)例：
return shell_exec("echo $input | $markdown_script");
清單
_ MD支持有序列表和無序列表。_
- 無序列表使用
*、+、-作為清單標(biāo)記。(混用亦可)
* red
+ Green
- blue
** 展示方式： **
- red
- Green
- blue
- 有序列表使用
數(shù)字接著一個(gè)英文句點(diǎn)：
1. Bird
2. McHale
3. Parish
** 展示方式： **
- Bird
- McHale
- Parish
可以讓MD文件的清單數(shù)字和輸出的結(jié)果一致，也可不一致，即隨意輸入數(shù)字;
建議從1.開始，因?yàn)镸D未來可能會(huì)有序列表的start屬性。
- 關(guān)于清單列表的縮排：
- 清單標(biāo)記通常放在最左邊，其實(shí)亦可縮排，最多
3個(gè)空白,但標(biāo)記后面一定要接著至少一個(gè)空白或tab。 - 清單項(xiàng)目可以包含多個(gè)段落，每個(gè)項(xiàng)目下的段落都必須
縮排4個(gè)空白或是一個(gè)tab - _在行首出現(xiàn)不預(yù)知的
數(shù)字-句點(diǎn)-空白情況，可以在句點(diǎn)前加反斜杠\\避免。 _
* 這是第一行文本。
（加3個(gè)空白或者tab）這是第二行文本。
** 展示方式 **
- 這是第一行文本。
這是第二行文本。
- 清單內(nèi)引用區(qū)塊引言，則
>需要縮進(jìn)：
* 在清單中內(nèi)置區(qū)塊引用：
(空白或tab) > 需要縮排
** 展示方式： **
- 在清單中內(nèi)置區(qū)塊引用：
>需要縮排
- 如果要放程式區(qū)塊的話，該區(qū)塊引言就要縮排
2次，即8個(gè)空白或2個(gè)tab:
* 列表中放入代碼：
(2個(gè)tab或8個(gè)空白縮進(jìn))代碼在這里
** 展示方式: **
- 列表中放入代碼：
NSLog(@"hello world");
代碼區(qū)塊
-
代碼或者標(biāo)識語言原始碼寫作通常已經(jīng)有排版好的區(qū)塊。故我們并不希望它以一般段落文本的方式去排版，而是原樣輸出即可。 - MD自動(dòng)會(huì)用
<pre>和<code>標(biāo)識來將代碼塊包起來。 - _在程式碼區(qū)塊裡面，&、<和>會(huì)自動(dòng)轉(zhuǎn)成HTML實(shí)體，這樣的方式讓你非常容易使用Markdown插入範(fàn)例用的HTML原始碼，只需要複製貼上，再加上縮排就可以了，剩下的Markdown都會(huì)幫你處理，
- 在MD中建立代碼區(qū)塊，只要簡單的** 縮排
4個(gè)空白或1個(gè)tab即可。 **_ (一個(gè)代碼塊會(huì)一直持續(xù)到?jīng)]有縮排的那一行) _ ：
下面是個(gè)代碼區(qū)塊展示：
(4個(gè)空白或1個(gè)tab)NSLog(@"hello world") ;
**展示方式： **
下面是個(gè)代碼區(qū)塊展示：
NSLog(@"hello world") ;
NSLog(@"hello china") ;
_ 附錄：程式碼區(qū)塊中，一般的Markdown語法不會(huì)被轉(zhuǎn)換，像是星號便只是星號，這表示你可以很容易地以Markdown語法撰寫Markdown語法相關(guān)的文件。_
分割線
- 可在一行中用3個(gè)或者以上的
*、-、_來建立一個(gè)分割線，但行內(nèi)不能有其它元素。
_亦可在*中間插入空白，均可建立分割線。 - 本示例以及下文中的MD原始語法，均以代碼塊的形式展示
* * * *** *********** -- -- -*_ ____**展示方式： **
-*_
區(qū)段元素
- MD支持2種形式的鏈接語法：
行內(nèi)鏈接和參考鏈接。 - 鏈接的文字均是用
[鏈接文字]來標(biāo)識。
行內(nèi)鏈接 這是 [示例1](http://www.baidu.com/ "title") inline link. [示例2](http://www.baidu.com/)沒有title屬性。 連接同主機(jī)的資源，可以使用相對路徑： 點(diǎn)擊關(guān)于 [About](/about) 查看詳情。 參考形式的鏈接: 1. 使用另外一個(gè)[]接在鏈接文字的方括號后面，而在第二個(gè)[]里面要填入用以鏈接的標(biāo)簽。 2. 然后在文件的其它任意處，把[id]標(biāo)簽鏈接內(nèi)容定義出來。 這是個(gè) [參考鏈接][1] 的鏈接。 定義[id] [a]: http://www.baidu.com "title"** 展示方式: **
這是 示例1 inline link.
示例2 無title屬性。點(diǎn)擊關(guān)于 About 查看詳情。
這是個(gè) [參考鏈接] [a] 的鏈接。
[a]: http://www.baidu.com "title"
強(qiáng)調(diào)
- MD使用
*、_作為標(biāo)記強(qiáng)調(diào)字詞的符號。符號和文本之間不留空白
**`\*\*` 號展示著重文本形式** _ `_`號展示斜體文本形式 _ **`\*\*` 號展示著重文本形式** __`\_\_`號展示著重文本形式__
** 展示方式： **
\*號展示斜體文本形式
\_號展示斜體文本形式
\*\*號展示著重文本形式
\_\_號展示著重文本形式
代碼
- 若要標(biāo)記一小段行內(nèi)代碼，可以用
\`號將其包起來：
文本中間有代碼：`NSLog(@"hello world");` 的MD標(biāo)識方式。** 展示方式： **
文本中間有代碼：
NSLog(@"hello world");的MD標(biāo)識方式。
圖片
- MD使用一種和
鏈接很相似的語法來標(biāo)記圖片。同樣也允許有2種樣式：行內(nèi)和參考。
- (** 目前為止，無法指定圖譜安的寬高，如需要，則使用普通的
<img>標(biāo)簽 **)
行內(nèi)：
![alet 文本] (/path/to/img.jpg)
![alet 文本] (/path/to/img.jpg "title")
** 展示如下：
! [alet] (/path/to/img.jpg)
! [alet 文本] (/path/to/img.jpg "title")參考：
! [alert text] [id]
[id]: url/to/image "title"
** 展示 **
! [alert text] [a]
[a]: url/to/image "title"
其他
- 自動(dòng)鏈接(MD支持簡短的自動(dòng)鏈接，以處理網(wǎng)址和email地址)：
<http://www.baidu.com>**展示： **
http://www.baidu.com
跳脫字元
- MD可以利用
\來插入一些在語法中有其它意義的符號。如將*號置于文字旁邊顯示強(qiáng)調(diào)效果：
\* 這是個(gè)顯示強(qiáng)調(diào)效果的文本。 \* (此處無效果，待查)** 展示 **
*這是個(gè)顯示強(qiáng)調(diào)效果的文本。*Markdown支援在下面這些符號前面加上反斜線來幫助插入普通的符號:
\ 反斜線 ` 反引號 * 星號 _ 底線 {} 大括號 [] 方括號 () 括號 # 井字號 + 加號 - 減號 . 英文句點(diǎn) ! 驚嘆號
附：
- 本文參考自 Markdown 語法說明 。
- 本文僅是參考文檔的縮略版，方便自己快速查找語法的使用。隨著自己不斷的運(yùn)用md工具，本文將不斷積累。
