简述
- Markdown 语法的目标是：成为一种适用于网络的书写语言。 它的语法种类很少，只对应 HTML 标记的一小部分。它能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。
- Markdown 的格式语法只涵盖纯文本可以涵盖的范围。不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。要制约的只有一些HTML 区块元素――比如 div、table、p和pre 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
- Markdown 语法在 HTML 区块标签间使用无效果，而在 HTML 区段标签间是有效的。
目录
- 简述
- 特殊字符自动转换
- 区块元素
- 段落和换行
- 标题
- 区块引用
- 列表
- 代码区块
- 分割线
- 区段元素
- 链接
- 强调
- 代码
- 图片
- 其他
- 反斜杠
- 自动链接
Markdown 语法说明（简体中文）详见：http://wowubuntu.com/markdown/#hr
特殊字符自动转换
- 在 HTML 文件中，有两个字符需要特殊处理： <和 &。 <符号用于起始签，&符号则用于标记 HTML 实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式，像是 < ;和 & ;。而网址中的 &字符也要转换，才能放到链接标签的 href属性里。
- Markdown 让你可以自然地书写字符，需要转换的由它来处理好了。如果你使用的 &字符是 HTML 字符实体的一部分，它会保留原状，否则它会被转换成&。比如要在文档中插入一个版权符号 ©，可以这样写：©copy ，Markdown 会保留它不动。而若你写：AT&T，Markdown 就会将它转为：AT& ;T
- 类似，如果你是把 <符号作为 HTML 标签的定界符使用，那 Markdown 也不会对它做任何转换，但是如果你写：4 < 5，Markdown 将会把它转换为：4 < ; 5
- 不过需要注意的是，code 范围内，不论是行内还是区块， <和 &两个符号都一定会被转换成 HTML 实体，这项特性让你可以很容易地用 Markdown 写 HTML code 。
区块元素
段落和换行
一个 Markdown 段落的前后要有一个以上的空行。普通段落 不该用空格或制表符来缩进。
如果你*确实*想要依赖 Markdown 来插入<br />标签的话，在插入处先按入两个以上的空格然后回车。
标题
Markdown 支持两种标题的语法，类Setext]和类atx形式。
类 Setext 形式是用底线的形式，利用=（最高阶标题）和-（第二阶标题），任何数量的=和-都可以
有效果。
类 Atx 形式则是在行首插入 1 到 6 个#，对应到标题 1 到 6 阶。
区块引用 Blockquotes
在 Markdown 文件中建立一个区块引用，只需在每行的最前面加上>
区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的>
引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等。
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记。
有序列表则使用数字接着一个英文句点。
1.列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要
接着至少一个空格或制表符。
2.列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。
3.如果要在列表项目内放进引用，那>就需要缩进。
4.如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符。
5. 在行首出现数字-句点-空白，项目列表很可能会不小心产生，像是下面这样的写法：
1986. What a great season.
要避免这样的状况，可以在句点前面加上反斜杠。1986\. What a great season.
代码区块
在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以。
一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。
代码区块中，&、<和>会自动转成 HTML 实体，只需要复制贴上，再加上缩进就可以了，
剩下的 Markdown 都会帮你处理。
代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号，这表示你可以很容易地以
Markdown 语法撰写 Markdown 语法相关的文件。
分隔线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在
星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
* *
*********
- - -
---------------------------------------
区段元素
链接
- Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。不管是哪一种，链接文字都是用 [方括号] 来标记。
- 要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可。如果你是要链接到同样主机的资源，你可以使用相对路径。如：
This is an exampleinline link.
See my About page for details.
详见源代码。 -
参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记(链接辨别标签可以有字母、数字、空白和标点符号，但是并不区分大小写)，也可以选择性地在两个方括号中间加上一个空格，接着，在文件的任意处，你可以把这个标记的链接内容定义出来。如：
This is an example reference-style link.
This is an example reference-style link.
id: http://example.com/ "Optional Title Here"
链接内容定义的形式为：
1.方括号（前面可以选择性地加上至多三个空格来缩进）里面输入链接文字
2.接着一个冒号
3.接着一个以上的空格或制表符
4.接着链接的网址
5.选择性地接着 title 内容，可以用单引号、双引号或是括弧包着
下面这三种链接的定义都是相同：
1.[foo]: http://example.com/ "Optional Title Here"
2.[foo]: http://example.com/ 'Optional Title Here'
3.[foo]: http://example.com/ (Optional Title Here)
链接网址也可以用尖括号包起来,如：
也可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看：
隐式链接标记功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 "Google" 链接到 google.com，你可以简化成：
然后定义链接内容：
下面是一个参考式链接的范例：
I get 10 times more traffic from [Google] [1] than from[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
如果改成用链接名称的方式写：
I get 10 times more traffic from Google than from[Yahoo][] or [MSN][].
google: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
强调
- Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被\ *或 _包围的字词会被转成用 < em >标签包围，用两个\ *或_包起来的话，则会被转成 < strong > 。
- 但是如果你的 *和 _ 两边都有空白的话，它们就只会被当成普通的符号。
- 如果要在文字前后直接插入普通的星号或底线，你可以用反斜线：
\ *this text is surrounded by literal asterisks\ *
代码
-
如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：
Use the
printf()function.如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：
There is a literal backtick (`) here.
代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号：
A single backtick in a code span:
`
A backtick-delimited string in a code span:`foo`
在代码区段内，&和尖括号都会被自动地转成 HTML 实体。
—is the decimal-encoded equivalent of—.
Please don't use any<blink>tags.
图片
Markdown 允许两种样式来标记图片:行内式和参考式。
-
行内式的图片语法看起来像是：
a cat
a dog
详细叙述如下：
1.一个惊叹号 !
2.接着一个方括号，里面放上图片的替代文字
3.接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。 -
参考式的图片语法则长得像这样：
Alt text
「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：
到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 < img >标签。
其他
自动链接
- Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。
反斜杠
- Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
` 反引号\ 反斜线
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
\ + 加号
\ - 减号
. 英文句点
! 惊叹号
