Markdown to Word

This page reads the .md file on your machine and writes the .docx: headings become Word's own Heading 1 to 6, the tables become tables, the code blocks keep their monospace font and grey box.

Need a PDF at the end? Convert the .docx with Word to PDF.

  • No account
  • No watermark
  • No file limit
Drop your files hereor click to chooseNo size or count limit beyond what your own computer can hold.There is no upload bar here, because there is no upload. The file is opened by this page, on your machine.

Your files

Only needed if your .md points at image files sitting next to it. Matched by file name. Images written as a data URI need nothing here.

    Nothing chosen yet.

    What this tool does for you

    The parts worth knowing before you start.

    The headings are real Word headings

    They use Heading 1 through 6, so the navigation pane fills in, References → Table of Contents works, and the whole document can be restyled by changing one style.

    Tables and nested lists survive

    Pipe tables come out as Word tables with a shaded header row that repeats across pages. Nested bullets and numbered lists keep their levels, and the numbers restart where your Markdown said they do.

    It tells you what it skipped

    Images pointing at a web address are not fetched. They are counted and reported, and the alt text stays in the document so you know where a picture belonged.

    The file never leaves your computer

    Internal notes, drafts and specs are the usual contents of a .md file. The conversion happens in your browser; there is no server.

    How to use Markdown to Word

    Choose your .md file, or several: they come back as separate .docx files.

    If the Markdown references images sitting next to it on disk, add those images in the second box so they can be embedded.

    Press Start, then download the .docx.

    When people use it

    The reader does not use Markdown

    You wrote the spec in your editor; legal, finance or the client wants something they can open, comment on and track changes in.

    A submission form only takes .docx

    Grant applications, journals and internal templates still ask for Word, and a PDF is not accepted because they want to edit it.

    Turning notes into a document to mark up

    Meeting notes and design drafts get useful once people can leave comments in the margin, and that means Word.

    Questions about Markdown to Word

    Will it look like my Markdown preview?

    No. A preview in your editor is a web page; this is a Word document laid out on A4 or Letter with Word's styles. Headings, bold, italic, strikethrough, inline code, links, quotes, rules, tables and lists all carry over, but the exact fonts and spacing are Word's, not your theme's.

    What happens to images?

    Images written as a data URI go straight in. Images that sit next to the .md file on your disk go in too, if you add them in the second box; the file name in the Markdown is matched against the files you chose. Images pointing at a web address are skipped and counted. Their alt text is left in the document in italics so the gap is visible.

    What does not survive the conversion?

    Footnotes, math written in LaTeX, Mermaid or other diagram blocks, and admonition or callout syntax from specific static site generators. Raw HTML in the Markdown is dropped down to its text: a <div> wrapper disappears and the words inside stay. YAML front matter at the top is removed, though a title: line in it is used as the document title. Links pointing at another file or an anchor become plain text.

    Can I convert several files at once?

    Yes. Each .md becomes its own .docx. Two or more arrive as a single zip.

    Does it handle Chinese, Japanese or Korean?

    Yes. No fonts are embedded, so Word uses whatever it normally uses for those characters on the machine that opens the file. A 5,000-line Markdown file comes out a few hundred kilobytes.

    Is my file uploaded?

    No. The page reads the .md straight from your disk, builds the Word document in the tab, and hands it back as a download. Nothing is sent anywhere; you can watch the network tab while it runs.

    Can I choose A4 or Letter page size?

    Yes. There is a page size list with A4 and Letter, and A4 is the default. The usable text width is worked out from the page you pick, so set it before you press Start rather than changing the paper size in Word afterwards.

    Do task list checkboxes carry over to Word?

    Yes, as characters. A ticked item written - [x] starts with ☒ and an open one written - [ ] starts with ☐, followed by the item text with its normal list bullet or number. They are plain text in the document, not clickable form boxes, so ticking one in Word means swapping the character.

    Which fonts does the Word file use?

    Body text is set in Calibri. Code blocks and inline code use Consolas, and inline code gets a light grey background. Since these are Word styles, you can change the font for the whole document by editing the style once in Word.

    Other tools