![markdown-logo.png][markdown-logo]
[markdown-logo]: http://upload-images.jianshu.io/upload_images/947566-5c4a6d0c90dee65d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」。
行內(nèi)HTML
- 不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽躏筏，可以直接在文檔里面用 HTML 撰寫粘拾。
- 例外：塊區(qū)元素
<div> <table> <pre> <p>茁裙，必須在前后加上空白。且不可用空白來(lái)縮排擎勘。
特殊字符自動(dòng)轉(zhuǎn)換
例如：在 HTML 文檔中霉涨，有兩個(gè)字符需要特殊處理： < 和 &。
標(biāo)題：
Markdown 支持兩種標(biāo)題的語(yǔ)法餐茵，[Setext][]和 [atx][] 形式。
[Setext]: http://docutils.sourceforge.net/mirror/setext.html
[atx]: http://www.aaronsw.com/2002/atx/
- Setext 形式是用底線的形式述吸，利用
=（一級(jí)標(biāo)題）和-（二級(jí)標(biāo)題） - Atx 形式則是在行首插入 1 到 6 個(gè)
#忿族，對(duì)應(yīng)到標(biāo)題 1 到 6
引言:Blockquotes
- Markdown 文檔中建立一個(gè)區(qū)塊引言，那會(huì)看起來(lái)像是強(qiáng)迫斷行刚梭，然后在每行的最前面加上
> - 允許只在整個(gè)段落的第一行最前面加上
> - 區(qū)塊引言可以有級(jí)別（例如：引言內(nèi)的引言）肠阱，只要根據(jù)級(jí)別加上不同數(shù)量的
> - 引言的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法票唆，包括標(biāo)題朴读、列表、程序代碼區(qū)塊等
列表
Markdown 支持有序列表和無(wú)序列表
- 無(wú)序列表使用星號(hào)
*走趋、加號(hào)+或是減號(hào)-作為列表標(biāo)記 - 有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)
- 列表項(xiàng)目可以包含多個(gè)段落衅金，每個(gè)項(xiàng)目下的段落都必須縮排 4 個(gè)空白或是一個(gè)
tab
程序代碼區(qū)塊
Markdown 會(huì)用 <pre>和<code>標(biāo)簽來(lái)把程序代碼區(qū)塊包起來(lái)。
- 代碼塊：縮排 4個(gè)空白或是 1 個(gè)
tab就可以簿煌；或直接使用<pre></pre> - 高亮：使用 <code>`</code> 或直接使用
<code></code> - 用 <code>
</code>包裹一段代碼氮唯，并指定一種語(yǔ)言 <pre>\javascript
$(document).ready(function () {
alert('hello world');
});
```
</pre>
支持的語(yǔ)言：actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml
分隔線
在一行中用三個(gè)或以上的星號(hào)*、減號(hào)-姨伟、底線_來(lái)建立一個(gè)分隔線惩琉，行內(nèi)不能有其他東西
鏈接
Markdown 支持兩種形式的鏈接語(yǔ)法： 「行內(nèi)」和「參考」兩種形式。
- 建立一個(gè)行內(nèi)形式的鏈接夺荒，只要在方塊括號(hào)后面馬上接著括號(hào)并插入網(wǎng)址鏈接即可瞒渠。
- 參考形式的鏈接使用另外一個(gè)方括號(hào)接在鏈接文字的括號(hào)后面，而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)簽技扼；接著伍玖，在文檔的任意處，可以把這個(gè)標(biāo)簽的鏈接內(nèi)容定義出來(lái)剿吻。
強(qiáng)調(diào)
Markdown 使用星號(hào)*和底線_作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)窍箍。
- 被
*或_包圍的字詞會(huì)被轉(zhuǎn)成用<em>標(biāo)簽包圍。 - 用兩個(gè)
*或_包起來(lái)的話，則會(huì)被轉(zhuǎn)成<strong>椰棘。 - 如果
*和_兩邊都有空白的話纺棺，它們就只會(huì)被當(dāng)成普通的符號(hào)。 - 如果要在文字前后直接插入普通的星號(hào)或底線邪狞，可以用反斜杠
程序代碼
如果要標(biāo)記一小段行內(nèi)程序代碼五辽，可以用反引號(hào)<code>`</code>把它包起來(lái)
圖片
Markdown 使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片，同樣也允許兩種樣式： 「行內(nèi)」和「參考」外恕。
-
行內(nèi)語(yǔ)法：
Alt text
Alt text -
參考語(yǔ)法：
![Alt text][id]「id」是圖片參考的名稱杆逗，圖片參考的定義方式則和鏈接參考一樣：<pre>[id]:url/to/image "Optional title attribute"</pre>
自動(dòng)鏈接
Markdown 支持比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱，例如：
<http://example.com/>
<a >http://example.com/</a>
轉(zhuǎn)義字符
Markdown 可以利用<code></code>反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào)鳞疲。
支持在下面這些符號(hào)前面加上反斜杠來(lái)幫助插入普通的符號(hào)：
<pre>
\ 反斜杠
` 反引號(hào)
* 星號(hào)
_ 底線
{} 大括號(hào)
[] 方括號(hào)
() 括號(hào)
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)
</pre>
