12.8 Markdown export

md export back-end generates Markdown syntax¹⁴⁸ for an Org mode buffer.

It is built over HTML back-end: any construct not supported by Markdown syntax (e.g., tables) will be controlled and translated by html back-end (see HTML export).

Markdown export commands

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

Export as a text file written in Markdown syntax. For an Org file, myfile.org, the resulting file will be myfile.md. The file will be overwritten without warning.

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

Export to a temporary buffer. Do 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

Markdown export can generate both atx and setext types for headlines, according to org-md-headline-style. The former introduces a hard limit of two levels, whereas the latter pushes it to six. Headlines below that limit are exported as lists. You can also set a soft limit before that one (see Export settings).