Markdown 语法说明(简体中文版)_全

markdown 全部语法

2015/11/29

Markdown 语法说明(简体中文版)

<<访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax.声明：这份文档派生(fork)于繁体中文版，在此基础上进行了繁体转简体工作，并进行了适当的润色。此文档用 Markdown语法编写，你可以到这里查看它的源文件。「繁体中文版的原始文件可以查看这里。」--By@riku注：本项目托管于 GitCafe上，请通过"派生"和"合并请求"来帮忙改进本项目。 *** AD:本网站托管于具备 SSD硬盘的 http://www.77cn.com.cn VPS服务商，点击此处进入购买，即可免费获赠 10USD优惠款！

Markdown语法说明 (简体中文版)/ (点击查看快速入门)概述宗旨兼容 HTML特殊字符自动转换区块元素段落和换行标题区块引用列表代码区块分隔线区段元素链接强调代码图片其它反斜杠自动链接感谢 Markdown免费编辑器

概述宗旨Markdown的目标是实现「易读易写」。可读性，无论如何，都是最重要的。一份使用 Markdown格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。Markdown语法受到一些既有 text-to-HTML格式的影响，包括 Setext、atx、Textile、reStructuredText、Grutatext和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。总之， Markdown的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。比如：在文字两旁加上星号，看起来就像*强调*。Markdown的列表看起来，嗯，就是列表。Markdown的区块引用看起来就真的像是引用一段文字，就像你曾在电子邮件中见过的那样。

兼容 HTMLMarkdown语法的目标是：成为一种适用于网络的书写语言。 Markdown不是想要取代 HTML,甚至也没有要和它相近，它的语法种类很少，只对应 HTML标记的一小部分。Markdown的构想不是要使得 HTML文档更容易书写。在我看来， HTML已经很容易写了。Markdown的理念是，能让文档更容易读、写和随意改。HTML是一种发布的格式，Markdown是一种书写的格式。就这样，Markdown的格式语法只涵盖纯文本可以涵盖的范围。不在 Markdown涵盖范围之内的标签，都可以直接在文档里面用 HTML撰写。不需要额外标注这是 HTML或是 Markdown;只要直接加标http://www.77cn.com.cn/markdown/index.html 1/13

markdown 全部语法

2015/11/29

Markdown 语法说明(简体中文版)

签就可以了。要制约的只有一些 HTML区块元素――比如<p>、<table>、<pre>、<p>等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown的生成器有足够智能，不

会在 HTML区块标签外加上不必要的<p>标签。例子如下，在 Markdown文件里加上一段 HTML表格：这是一个普通段落。<table><tr><td>Foo</td></tr></table>这是另一个普通段落。

请注意，在 HTML区块标签间的 Markdown格式语法将不会被处理。比如，你在 HTML区块内使用 Markdown样式的 *强调*会没有效果。 HTML的区段(行内)标签如<span>、<cite>、<del>可以在 Markdown的段落、列表或是标题里随意使用。依照个人习惯，甚至可以不用 Markdown格式，而直接采用 HTML标签来格式化。举例说明：如果比较喜欢 HTML的<a>或<img>标签，可以直接使用这些标签，而不用 Markdown提供的链接或是图像标签语法。和处在 HTML区块标签间不同，Markdown语法在 HTML区段标签间是有效的。

特殊字符自动转换在 HTML文件中，有两个字符需要特殊处理：<和&。<符号用于起始标签，&符号则用于标记 HTML实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式，像是&lt;和&amp;。&字符尤其让网络文档编写者受折磨，如果你要打「 AT&T」,你必须要写成「 AT&amp;T」。而网址中的&字符也要转换。比如你要

链接到：http://www.77cn.com.cn/images?num=30&q=larry+bird

你必须要把网址转换写为：http://www.77cn.com.cn/images?num=30&amp;q=larry+bird

才能放到链接标签的 href属性里。不用说也知道这很容易忽略，这也可能是 HTML标准检验所检查到的错误中，数量最多的。 Markdown让你可以自然地书写字符，需要转换的由它来处理好了。如果你使用的&字符是 HTML字符实体的一部分，它会保留原状，否则它会被转换成&amp;。所以你如果要在文档中插入一个版权符号©,你可以这样写：&copy;

Markdown会保留它不动。而若你写：AT&T

Markdown就会将它转为：AT&amp;T

类似的状况也会发生在<符号上，因为 Markdown允许兼容 HTML,如果你是把<符号作为 HTML标签的定界符使用，那 Markdown也不会对它做任何转换，但是如果你写：4< 5

Markdown将会把它转换为：4&lt; 5

不过需要注意的是，code范围内，不论是行内还是区块，<和&两个符号都一定会被转换成 HTML实体，这项特性让你可以很容易http://www.77cn.com.cn/markdown/index.html 2/13

markdown 全部语法

2015/11/29

Markdown 语法说明(简体中文版)

地用 Markdown写 HTML code (和 HTML相对而言， HTML语法中，你要把所有的<和&都转换为 HTML实体，才能在 HTML文件里面写出 HTML code。)

区块元素段落和换行一个 Markdown段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行

只包含空格和制表符，则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown允许段落内的强迫换行(插入换行符),这个特性和其他大部分的 text-to-HTML格式不一样(包括 Movable Type的「Convert Line Breaks」选项),其它的格式会把每个换行符都转成标签。如果你确实想要依赖 Markdown来插入标签的话，在插入处先按入两个以上的空格然后回车。的确，需要多费点事(多加空格)来产生,但是简单地「每个换行都转换为」的方法在 Markdown中并不适合， Markdown中 email式的区块引用和多段落的列表在使用换行来排版的时候，不但更好用，还更方便阅读。

标题Markdown支持两种标题的语法，类 Setext和类 atx形式。类 Setext形式是用底线的形式，利用= (最高阶标题)和 - (第二阶标题),例如：This is an H1============= This is an H2 -------------

任何数量的=和 -都可以有效果。类 Atx形式则是在行首插入 1到 6个#,对应到标题 1到 6阶，例如：#这是 H1##这是 H2######这是 H6

你可以选择性地「闭合」类 atx样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上#,而行尾的#数量也不用和开头一样(行首的井字符数量决定标题的阶数):#这是 H1###这是 H2#####这是 H3######

区块引用 BlockquotesMarkdown标记区块引用是使用类似 email中用>的引用方式。如果你还熟悉在 email信件中的引言部分，你就知道怎么在 Markdown文件中建立一个区块引用，那会看起来像是你自己先断 …… 此处隐藏：14936字，全部文档内容请下载后查看。喜欢就下载吧 ……