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

Markdown的目标是实现「易读易写」。 可读性，无论如何，都是最重要的。一份使用Markdown格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签 或是格式指令所构成。Markdown语法受到一些既有text-to-HTML格式的影响，包括Setext、atx、Textile、reStructuredText、 Grutatext和EtText，而最大灵感来源其实是纯文本电子邮件的格式。 总之，Markdown的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。比如：在文字两旁加上星号，看起来就像* 强调*。Markdown的列表看起来 Markdown 是一种轻量级的标记语言，旨在使文档的编写简单、易读、易写。它的设计灵感来源于多种text-to-HTML格式，如Setext、atx等，但主要受到纯文本电子邮件格式的启发。Markdown 的语法简洁明了，通过一些特定的符号来实现格式化，比如使用星号`*`来表示强调。 在Markdown中，段落是通过换行来创建的，连续的段落之间只需一个空行即可。标题的创建有两种方式：Setext风格，使用`-`或`=`下划线，如`---`或`===`；Atx风格，使用`#`号，如`#`到`#####`分别代表一级到六级标题。区块引用可以通过在文字前添加`>`来实现，看起来就像是电子邮件中的引用回复。 Markdown 支持无序和有序列表，无序列表使用星号`*`、加号`+`或减号`-`，有序列表则使用数字加点号，如`1.`。代码区块可以用四个空格或者一个反引号````来包围，用来展示代码片段。分隔线可以使用三个或更多连续的`-`或`*`。 Markdown 提供了链接和强调的功能。使用方括号`[]`定义链接的文字，然后在后面加上括号`()`定义链接地址，如`[Google](https://www.google.com)`。强调则用单星号`*`或下划线`_`包裹，例如`*斜体*`和`_斜体_`，双星号`**`或双下划线`__`用于粗体，如`**粗体**`和`__粗体__`。图片的插入与链接类似，但前面多了一个感叹号`!`，如``。 Markdown 兼容HTML，这意味着在需要使用HTML标签时，可以直接在Markdown文档中插入。不过，HTML的区块元素如`<div>`、`<table>`等需要前后有空行，并且不应有制表符或空格缩进。Markdown 会忽略这些HTML区块内的Markdown语法。而对于HTML的行内标签，如`<span>`、`<cite>`等，Markdown则会保留其效果，与Markdown语法并存。 特殊字符的自动转换是Markdown的一个便利特性。在HTML中，`<`和`&`是敏感字符，需要转换为`&lt;`和`&amp;`。Markdown会自动处理这个问题，确保在输出HTML时，这些字符正确显示。例如，`AT&T`在Markdown中写作`AT&T`，在输出时会转换为`AT&T`。同样，如果`&`是HTML实体的一部分，Markdown会保持不变，如`&copy;`会保持为版权符号`©`。 Markdown 的设计理念是为了提升可读性和写作效率，而不是替代HTML。它专注于文本内容的撰写，而HTML更适合用于格式化和布局。这种分离使得Markdown适合于快速编写文档，然后轻松转换为HTML以在网页上展示。Markdown 的广泛支持和工具链，如Gitbook，使其成为开发者和内容创作者的首选格式。