Markdown 语法记录

区块元素

标题

使用1-6个#，或者使用=和-，来标记不一样阶的标题:
This is an H1
=========

This is an H2
-------------

或者是：
# 这是 H1

## 这是 H2

###### 这是 H6

区块引用

Markdown 标记区块引用是使用相似 email 中用 > 的引用方式。

区块引用能够嵌套（例如：引用内的引用），只要根据层次加上不一样数量的 > 。

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号(*)、加号(+)或是减号(-)做为列表标记。

有序列表则使用数字接着一个英文句点。

代码区块

要在 Markdown 中创建代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就能够。

分割线

你能够在一行中用三个以上的星号、减号、底线来创建一个分隔线，行内不能有其余东西。你也能够在星号或是减号中间插入空格。下面每种写法均可以创建分隔线：

* * *

***

*****

- - -

---------------------------------------

区段元素

连接

Markdown 支持两种形式的连接语法： 行内式和参考式两种形式。

无论是哪种，连接文字都是用 [方括号] 来标记。

要创建一个行内式的连接，只要在方块括号后面紧接着圆括号并插入网址连接便可，若是你还想要加上连接的 title 文字，只要在网址后面，用双引号把 title 文字包起来便可，例如：

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

会产生：

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

若是你是要连接到一样主机的资源，你可使用相对路径：

See my [About](/about/) page for details.

参考式的连接是在连接文字的括号后面再接上另外一个方括号，而在第二个方括号里面要填入用以辨识连接的标记：

This is [an example][id] reference-style link.

你也能够选择性地在两个方括号中间加上一个空格：

This is [an example] [id] reference-style link.

接着，在文件的任意处，你能够把这个标记的连接内容定义出来：

[id]: http://example.com/  "Optional Title Here"

连接内容定义的形式为：

方括号（前面能够选择性地加上至多三个空格来缩进），里面输入连接文字
接着一个冒号
接着一个以上的空格或制表符
接着连接的网址
选择性地接着 title 内容，能够用单引号、双引号或是括弧包着

下面这三种连接的定义都是相同：

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

请注意：有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的连接 title。

连接网址也能够用尖括号包起来：

[id]: <http://example.com/>  "Optional Title Here"

你也能够把 title 属性放到下一行，也能够加一些缩进，若网址太长的话，这样会比较好看：

[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"

网址定义只有在产生连接的时候用到，并不会直接出如今文件之中。

连接辨别标签能够有字母、数字、空白和标点符号，可是并不区分大小写，所以下面两个连接是同样的：

[link text][a]
[link text][A]

隐式连接标记功能让你能够省略指定连接标记，这种情形下，连接标记会视为等同于连接文字，要用隐式连接标记只要在连接文字后面加上一个空的方括号，若是你要让 "Google" 连接到 google.com，你能够简化成：

[Google][]

而后定义连接内容：

[Google]: http://google.com/

因为连接文字可能包含空白，因此这种简化型的标记内也许包含多个单词：

Visit [Daring Fireball][] for more information.

而后接着定义连接：

[Daring Fireball]: http://daringfireball.net/

连接的定义能够放在文件中的任何一个地方，我比较偏好直接放在连接出现段落的后面，你也能够把它放在文件最后面，就像是注解同样。

下面是一个参考式连接的范例：

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"

上面两种写法都会产生下面的 HTML。

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

下面是用行内式写的一样一段内容的 Markdown 文件，提供做为比较之用：

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

参考式的连接其实重点不在于它比较好写，而是它比较好读，比较一下上面的范例，使用参考式的文章自己只有 81 个字符，可是用行内形式的却会增长到 176 个字元，若是是用纯 HTML 格式来写，会有 234 个字元，在 HTML 格式中，标签比文本还要多。

使用 Markdown 的参考式连接，可让文件更像是浏览器最后产生的结果，让你能够把一些标记相关的元数据移到段落文字以外，你就能够增长连接而不让文章的阅读感受被打断。

强调

Markdown 使用星号（*）和底线（_）做为标记强调字词的符号，被 *或 _包围的字词会被转成用 <em> 标签包围，用两个 *或 _包起来的话，则会被转成 <strong>。

代码

若是要标记一小段行内代码，你能够用反引号把它包起来（`），例如：

Use the `printf()` function.