---

13.11 Markdown Export

The Markdown export back-end, “md”, converts an Org file to Markdown format, as defined at https://daringfireball.net/projects/markdown/.

Since it is built on top of the HTML back-end (see HTML Export), it converts every Org construct not defined in Markdown syntax, such as tables, to HTML.

Markdown export commands

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

Export to a text file with Markdown syntax. For ‘myfile.org’, Org exports to ‘myfile.md’, overwritten without warning.

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

Export to a temporary buffer. Does not create a file.

C-c C-e m o ¶

Export as a text file with Markdown syntax, then open it.

Header and sectioning structure

Based on org-md-headline-style, Markdown export can generate headlines of both atx and setext types. atx limits headline levels to two whereas setext limits headline levels to six. Beyond these limits, the export back-end converts headlines to lists. To set a limit to a level before the absolute limit (see Export Settings).