13.11 Markdown Export

Markdown 导出后端 “md” 可将 Org 文件转换为 Markdown 格式,格式定义参见 https://daringfireball.net/projects/markdown/。该格式为原始 Markdown 规范,由 John Gruber 与 Aaron Swartz 制定。

由于 “md” 后端基于 HTML 后端构建(参见 HTML Export),对于 Markdown 语法中未定义的 Org 结构(如表格),它会将其转换为 HTML 格式。

需要注意的是,原始 Markdown 语法与其他常用 Markdown 方言存在差异。更多细节可参见 https://en.wikipedia.org/wiki/Markdown

Markdown export commands

C-c C-e m m (org-md-export-to-markdown)

导出为 Markdown 语法的文本文件。对于 ‘myfile.org’ ,Org 会导出为 ‘myfile.md’ ,且直接覆盖不做提示。

C-c C-e m M (org-md-export-as-markdown)

导出至临时缓冲区,不创建文件。

C-c C-e m o

导出为 Markdown 语法的文本文件并打开。

Header and sectioning structure

依据 org-md-headline-style 的设置,Markdown 导出可生成 atxsetext 两种类型的标题。 setext 仅支持两级标题,而 atx 支持六级标题。 mixed 模式会将一级、二级标题以 setext-样式导出,三至六级标题以 atx-样式导出。超出上述层级限制时,导出后端会将标题转换为列表。可在绝对限制之前设置层级上限(参见 Export Settings)。