Skip to main content

13.11 Markdown Export

The Markdown export back-end, “md", converts an Org file to Markdown format, as defined at

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 ‘’, Org exports to ‘’, 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).