《Markdown 语法说明(简体中文版)》.pdf

访问 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上 ，请通过派生和合并请求 来帮忙改进本项 目。 Markdown 语法说明 (简体中文版) / (点击查看快速入门) 概述 宗 旨 兼容 HTML 特殊字符 自动转换 区块元素 段落和换行 标题 区块引用 列表 代码区块 分隔线 区段元素 链接 强调 代码 图片 其它 反斜杠 自动链接 感谢 Markdown 免费编辑器 概述 宗 旨 Markdown 的目标是实现 「易读易写」。 可读性 ，无论如何 ，都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布 ，并且看起来不会像是由许多标签 或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响 ，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText ，而最大灵感来源其实是纯文本电子邮件的格式。 总之 ， Markdown 的语法全由一些符号所组成 ，这些符号经过精挑细选 ，其作用一目了然。比如 ：在文字两旁加上星号 ，看起来就像 *强 调*。Markdown 的列表看起来 ，嗯 ，就是列表。Markdown 的区块引用看起来就真的像是引用一段文字 ，就像你曾在电子邮件中见过的 那样。 兼容 HT ML Markdown 语法的目标是 ：成为一种适用于网络的书写语言。 Markdown 不是想要取代 HTML ，甚至也没有要和它相近 ，它的语法种类很少 ，只对应 HTML 标记的一小部分。Markdown 的构想不是要 使得 HTML 文档更容易书写。在我看来 ， HTML 已经很容易写了。Markdown 的理念是 ，能让文档更容易读、写和随意改。HTML 是一 种发布的格式 ，Markdown 是一种书写的格式。就这样 ，Markdown 的格式语法只涵盖纯文本可以涵盖的范围。 不在 Markdown 涵盖范围之内的标签 ，都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown ；只要直接加 标签就可以了。 要制约的只有一些 HTML 区块元素――比如 div、 table、 pre、 p 等标签 ，必须在前后加上空行与其它内容区隔开 ，还要求 它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能 ，不会在 HTML 区块标签外加上不必要的 p 标签。 例子如下 ，在 Markdown 文件里加上一段 HTML 表格 ： 这是一个普通段落。 table tr tdFoo/td /tr /table 这是另一个普通段落。 请注意 ，在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如 ，你在 HTML 区块内使用 Markdown 样式的 *强调*会没有效 果。 HTML 的区段 （行内）标签如 span、 cite、 del 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯 ，甚至可 以不用 Markdown 格式 ，而直接采用 HTML 标签来格式化。举例说明 ：如果比较喜欢 HTML 的 a 或 img 标签 ，可以直接使用这些 标签 ，而不用 Markdown 提供的链接或是图像标签语法。 和处在 HTML 区块标签间不同 ，Ma