Skip to content

Word to Markdown

Converts .docx into Markdown, mapping headings, lists, tables and footnotes and extracting images.

Getting a Word document into a repository, a static site or a ticket means Markdown, and the part that goes wrong is the headings: a document where someone made the text large and bold has no headings at all, and one where the styles were renamed in Korean has headings a naive converter cannot see.

🔒 Runs entirely in your browserwordmarkdownconvertdocx

Drop a .docx

Converted in this tab. The document is not uploaded.

Headings are recognised by their Word style — including a style renamed in another language, and a custom style that carries an outline level. Manually enlarged bold text is not a heading and is not converted into one.

How to use it

  1. Drop the .docx

    The panel at the bottom counts what it found — headings, paragraphs, lists, tables, footnotes, images — so a document that converted to nothing is obvious.

  2. Choose the table style

    Pipe tables are GFM and render on GitHub and most static sites. Turn them off for tab-separated text, which survives a plain-Markdown renderer.

  3. Take the zip if the document has images

    The Markdown and the image files come out together, with the folder name in the links matching the one in the zip.

Common questions

My headings did not convert.

They are probably not headings. Word recognises a heading by its style; text that was manually enlarged and bolded is a paragraph with formatting, and this tool does not promote it — guessing would turn every emphasised line into an H2.

Does it handle a Korean-language Word?

Yes. A heading style renamed in another language is still recognised, as is a custom style that carries an outline level — which is how most corporate templates are built.

What happens to tracked changes and comments?

Tracked insertions are taken as accepted and deletions as removed; comments are not carried into the Markdown. If the review state matters, resolve it in Word first.

Feed it from

Next

These accept what this tool produces, so the result can go straight in.