第38章 Flarum Markdown 扩展：排版规范、工具栏交互与扩展兼容性

版本：2.x Markdown

Markdown 扩展（flarum/markdown）允许用户用 Markdown 排版帖子，并在编辑器中添加格式工具栏。它是内置扩展，默认已启用。

它没有设置项也没有权限控制：所有能发帖的人都可以使用。

帖子排版

Markdown 以纯文本形式书写，因此帖子即使未经渲染也清晰可读。编辑器的预览功能可以实时显示排版效果。

想要实现的效果写法加粗bold斜体_italic_ 或 *italic*删除线~~strikethrough~~行内代码`inline code`上标^superscript下标~subscript标题行首的 #（一至六个）链接[text](https://example.com)图片引用行首的 > 加引用文字无序列表每行一个 - 项（也可用 * 或 +）有序列表每行一个 1. 项分隔线单独一行的 ---代码块用三反引号（```）的两行包裹代码剧透>!隐藏文字!<，或行内的 ||隐藏文字||，或行首的 >! 使整段隐藏

代码块可以在起始行声明语言（如 ```php），以获得语法高亮。高亮脚本在首次展示包含代码块的帖子时从 jsDelivr CDN 加载。

剧透内容会被隐藏，直到读者点击后显示。

不支持表格。像 | a | b | 这样的管道表格语法会原样显示为纯文本。

格式工具栏

编辑器会多出一个工具栏，包含标题、加粗、斜体、删除线、引用、剧透、代码、链接、图片、无序列表和有序列表的按钮。按钮会把选中的文本用对应的 Markdown 标记包裹，或在光标处插入标记。

有两个快捷键：Ctrl+B 加粗、Ctrl+I 斜体（Mac 上为 ⌘B 和 ⌘I）。

在列表项末尾按 Enter 会开启下一项，有序列表的编号自动递增。在空列表项上按 Enter 则结束列表。

禁用扩展

禁用 Markdown 后，帖子的文字内容仍会保留，但排版不再渲染：标题、强调、链接等全部变成纯文本，且 Markdown 标记字符也不会显示。BBCode 也能实现的排版（如引用和列表）在 BBCode 启用时仍可正常渲染。重新启用 Markdown 后，已有帖子的排版会恢复原样。

与其他扩展的配合

扩展对 Markdown 的补充BBCode两者可以同时启用，帖子中可以混用。Emoji在同一个编辑器工具栏上添加表情按钮。