Markdown to Word Converter

Why anyone needs this

Markdown is what you write in when the writing is the point. Word is what the other person opens. Somewhere between those two facts sits a document you drafted in a text editor that now has to go to a client, a supervisor, a committee or a legal team — people who will track changes, leave comments, and expect a file with a proper contents page.

The usual improvisations are bad. Pasting raw Markdown into Word gives you a page full of hashes and asterisks. Pasting rendered HTML gets the formatting roughly there but tends to arrive with strange fonts, broken list numbering and headings that are merely large text. Exporting to PDF removes the ability to edit, which is normally the whole reason the file was requested.

It is a real .docx

The file this tool produces is an Office Open XML package: the zipped collection of XML parts that Word itself writes when you save. It is not an HTML file with the extension changed, which is what a surprising number of converters hand you. That matters because Word opens renamed HTML in a degraded mode — a compatibility banner, lists that renumber themselves, tables that resist editing.

Because it is the genuine format, everything reads it: Word on Windows and Mac, Word on the web, Apple Pages, LibreOffice Writer, Google Docs via File → Open, and every collaboration tool that accepts a Word attachment.

Headings become real Word styles

This is the single most useful thing about converting properly, and it is worth being explicit. A Markdown # does not become twenty-point bold text. It becomes a paragraph carrying Word’s built-in Heading 1 style; ## becomes Heading 2, and so on to Heading 6.

# Quarterly Review        →  Heading 1
## The numbers            →  Heading 2
### One implementation note →  Heading 3

Word keys a great deal off those styles. The navigation pane (View → Navigation Pane) fills with your section list, so a forty-page document becomes something you can jump around. References → Table of Contents generates a real contents page in one click, with page numbers that update themselves. Restyling every heading in the document is one change to the style, not a hundred manual edits. Screen readers announce the structure. None of that works on text that has only been made to look like a heading.

What else comes across

• Inline formatting — bold, italic, the two combined, and strikethrough.
• Code — inline `spans` and fenced blocks both set in Consolas, blocks on a light shaded background so they read as code rather than prose.
• Lists — bulleted and numbered, nested to eight levels, using Word’s own numbering definitions so continuing a list in Word behaves normally.
• Task lists — - [ ] and - [x] become ☐ and ☒, since Word has no checkbox in ordinary body text.
• Tables — GFM pipe tables become Word tables with a shaded header row, hairline borders, and per-column alignment taken from the :--- markers.
• Blockquotes — indented with a rule down the left edge, nesting included.
• Links — real Word hyperlinks, blue and underlined, clickable in the document rather than printed as bare URLs.
• Horizontal rules — --- becomes a thin full-width rule.

What does not

Images are the notable gap. A Markdown image is a reference to a URL or a path, and the converter does not go out and fetch it, so it appears in the document as [image: alt text] — a marker telling you where to drop the real picture in Word. Footnotes and LaTeX maths have no clean Word equivalent either; footnote markers survive as text but do not become Word footnotes. Everything else on the list above converts fully.

Page size and margins

The page-size menu writes Letter (8.5 × 11 in) or A4 (210 × 297 mm) into the document’s section properties, so the file prints correctly wherever it lands without anyone visiting Page Setup. Margins are one inch on all four sides in both cases, matching Word’s default. The document title, if you set one, becomes the file’s title property, the Title-styled heading on page one, and the download filename.

Going the other way

If the document comes back from Word with tracked changes and you would rather keep working in Markdown, the reverse trip converts a .docx back. If the destination is a shared document rather than an attachment, Markdown to Google Docs gives you rich text you can paste straight into a Doc. And if you are assembling the Markdown from something else first, there are converters for PDF, HTML and Excel.

Notes that are already Markdown

Bulguritto is a notes app for iPhone, iPad and Mac where every note is a plain .md file rather than a row in a proprietary database. You write in Markdown, it syncs between your devices, and when someone needs a Word document you convert one — instead of fighting an editor that was never storing your text as text in the first place. It is free.