Markdown to Word

Word still has no Markdown importer. Paste a README into it and you get a wall of asterisks, pound signs and pipes — then twenty minutes of re-styling by hand before you can send it. This page reads the file on your machine and writes the .docx for you: headings become Word's own Heading 1 to 6, the tables become tables, the code blocks keep their monospace font and grey box.

  • No upload
  • No account
  • No watermark
  • No file limit
Drop your files hereor click to chooseNo size limit and no count limit — only what your own computer can hold.

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.

    Where your file goes

    Nowhere. This page downloads a small program into your browser, and that program reads the file straight from your disk. The program comes from this site like any image or stylesheet — but your file only ever travels from your disk into your own browser tab.

    Why this one

    What you get that the big converters cannot offer.

    The headings are real Word headings

    Not just bigger bold text. They use Heading 1 through 6, so the navigation pane fills in, Insert → Table of Contents works, and whoever you send it to can restyle the whole document by changing one style.

    Tables and nested lists survive

    These are the two things that never make it when you paste Markdown into Word. 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 — going out to get them would mean this page making a network request with your document in hand, which is the one thing it does not do. They are counted and reported instead, 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, and they are exactly what you would rather not hand to a conversion site. There is no server here to hand them to.

    How to use it

    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

    Will it look like my Markdown preview?

    No, and it is not trying to. 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. That is what makes the result editable rather than a picture of your preview.

    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, because downloading them would be a network request, and this page makes none. 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, because in a standalone .docx they would point at nothing.

    Can I convert several files at once?

    Yes. Each .md becomes its own .docx. Past three files they arrive as a single zip, because browsers block a run of downloads in a row and you would silently lose some.

    Does it handle Chinese, Japanese or Korean?

    Yes. The text goes in as text — no fonts are embedded, so Word uses whatever it normally uses for those characters on the machine that opens the file. That also means the document is small: 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 about it is sent anywhere — you can watch the network tab while it runs.

    Other tools