How to convert Markdown to Word

Write in Markdown, hand over a .docx, because that is what most people expect to receive.

Markdown is a pleasant way to write and an awkward thing to send to someone who expects a document. This produces a genuine .docx with the structure carried over.

Step-by-step

1. Paste your Markdown, or load a .md file.
2. Convert.
3. Download the .docx.

What carries across

• Headings become real Word heading styles, so a table of contents can be generated and the navigation pane works.
• Lists, ordered and unordered, including nesting.
• Bold, italic and inline code.
• Block quotes and code blocks.
• Links, as real hyperlinks.

Real heading styles matter

A heading that is merely large bold text looks like a heading and is not one. Word cannot build a table of contents from it, the navigation pane ignores it, and screen readers read it as ordinary text. Producing actual Heading 1 and Heading 2 styles is what makes the output a usable document rather than something that resembles one.

Styling afterwards

The .docx uses Word's built-in styles, so changing the look is a matter of changing the style — modify Heading 1 once and every heading follows. That is far better than the alternative, where each heading is independently formatted and consistency is your problem.

Frequently asked questions

Are headings real Word headings?

Yes. They use Word's built-in heading styles, so the navigation pane and automatic tables of contents both work.

Do tables convert?

Markdown tables become Word tables. Very wide ones may need column widths adjusting afterwards.

Is the file uploaded?

No. The .docx is assembled in your browser and downloaded directly.