通过 Markdown 区块,您可以使用常用字符和标点符号撰写带链接、列表及其他样式的文章和评论。
想要通过一种快速简便的方法来撰写丰富文本的作家和博主会使用 Markdown,这样他们手不离键盘即可进行撰写,也无需学习很多复杂的代码和快捷方式。
您可以将 Markdown 用于文章、页面和评论。本指南将详细介绍如何在您的博客上启用 Markdown 并使用它撰写文章。
如果您已熟悉 Markdown,请在博客上启用它并开始撰写。您可以参阅此 Markdown 参考页面以获取帮助。Markdown 区块遵循 CommonMark 规范(点击最新版本链接查看当前启用的功能)。
您必须先为您的站点启用 Markdown,然后才能使用 Markdown 区块。
- 访问您的仪表盘。
- 转到“Jetpack → 设置 → 写作”。
- 在“创作”下,点击“以纯文本 Markdown 语法撰写文章或编写页面”旁边的按钮。
- 如果“保存设置”按钮未显示为灰色,请点击该按钮以保存更改。

- 访问您的仪表盘。
- 转至“Jetpack → 设置 → 讨论”。
- 在“评论”下,点击“为评论启用 Markdown”旁边的按钮。
- 如果“保存设置”按钮未显示为灰色,请点击该按钮以保存更改。

要添加 Markdown 区块,请点击“+ 区块插入器”图标。
您也可以在新的段落区块中键入 /markdown 并按下 Enter 键,快速添加一个 Markdown 区块。

有关添加区块的详细说明,请点击此处查看。
通过每个区块自带的特定区块控件,您可以直接在编辑器中操作区块。Markdown 区块提供 Markdown 和“预览”选项卡以及更多选项控件。

在 Markdown 区块中撰写文章时,您会看到 Markdown 选项卡处于选中状态,这表明您应该在此处编写您的 Markdown 代码(有关 Markdown 格式的更多信息见下文)。
您可以点击“预览”选项卡,查看大致的详细信息。Markdown 内容将在发布后显示。(请注意,实际显示效果会因您的主题添加的样式而异。)

💡
如果您点击“预览”后仍然看到了 Markdown 代码,原因可能有两种。
- Markdown 尚未启用。按照以下步骤启用 Markdown。
- Markdown 不正确。点击此处查看参考指南。
如果您离开 Markdown 区块,则该区块将显示 Markdown 的预览。当您再次点击 Markdown 区块时,它将切换回 Markdown 选项卡,以便您可以继续写作。
Markdown 使用特殊字符和标点符号来表示样式和链接。您使用的特定字符以及在文档中放置这些字符的方式是设置文档格式的关键。Markdown 会在文档发布时将这些特殊字符转换为相应的格式。
例如,在 Markdown 中,要强调某个单词,您可以在单词的两端加上星号,如下所示:*emphasized*。您的文本发布后将显示为如下效果:emphasized。同样,两个星号表示强文本:**strong** 在发布后将显示为 strong。
要表示链接,请使用常规括号和方括号。用方括号括住要链接的文本,然后紧接着插入用常规括号括住的链接目标。实际的 Markdown 可能显示为如下效果:[WordPress.com](https://wordpress.com/)。发布后,它将成为标准链接:WordPress.com。

您撰写的原始 Markdown 文本将始终保留在 Markdown 中,因此您可以使用 Markdown 返回并编辑文本。只有已发布的文档(文章或页面)才会被转换。如果您在 Markdown 中撰写文章,它在您的博客上将以完全格式化的文章形式发布,但当您返回进行编辑时,它仍将在 Markdown 中。
开始使用 Markdown 的最佳方法是进行试验。打开 Markdown 参考指南,在您的博客上起草一篇文章,并尝试使用不同的功能。
Markdown 区块遵循 CommonMark 规范。它不支持 Markdown Extra。但是,经典编辑器支持 Markdown Extra。
什么是 Markdown Extra?
Michel Fortin 的 Markdown Extra 包含一些 Markdown 最初不提供的功能,包括加强了对内嵌 HTML、代码区块、表格等的支持。代码区块可以使用三个或以上的反勾号 (“`) 和代字号 (~~~)。
有关这方面的更多详细信息,请参阅 Markdown 原始参考指南和 Markdown Extra 页面。
选择一个区块后,您会在右侧边栏中找到其他区块设置。如果您没有看到边栏,您可能需要点击右上角的设置图标以打开设置。这个图标看起来像两个宽窄不一的栏目拼在一个方框里面:

Markdown 区块将包含一项尺寸设置,其中包括内边距或外边距选项。有关该选项的更多详细信息,请参阅以下“尺寸设置”指南。
如需了解更多相关信息,请访问我们关于高级设置的详细说明。
如果您使用的是经典编辑器,则必须启用 Markdown,并使用 HTML 选项卡插入 Markdown。以下是我们针对经典编辑器的 Markdown 参考指南。经典编辑器使用 Markdown Extra,其中有几个选项与 Markdown 区块中使用的 CommonMark 规范不同。
关于经典编辑器,需要注意的一个重要事项是,一旦保存更改,您就无法以 Markdown 格式编辑内容了。它将显示为带格式的内容或 HTML。但是,您可以改用 WordPress 编辑器的 Markdown 区块。