Convert DOCX to Markdown

How to convert DOCX to Markdown

Drop a .docx file above and press Convert. Mammoth reads the Word document into clean HTML in your browser, then Turndown writes that HTML as Markdown. Headings use # marks, bullet lists use dashes, numbered lists keep their numbers and links become [text](url). Download the .md file and drop it into your repo, wiki or notes app.

Why convert Word to Markdown

READMEs, GitHub and GitLab wikis, Obsidian, Notion imports and static site generators such as Hugo, Jekyll and Astro all use Markdown. Moving a document out of Word lets you keep it as plain text in version control, review changes line by line and edit it in any editor.

What carries over

Anything Word marks as structure converts cleanly. Paragraphs styled Heading 1 to Heading 6 become # to ###### headings, bold and italic become ** and _, and bulleted and numbered lists keep their nesting. Hyperlinks keep their address. Images are embedded inline as Base64 data URLs, which keeps the file self-contained but makes long lines.

What doesn't

Tables lose their grid and come through as plain text, one cell after another, so rebuild important tables by hand as pipe tables. Fonts, colours, alignment, page layout, headers, footers and comments are dropped, since Markdown has no way to express them. Text that only looks like a heading because it is big and bold becomes a normal paragraph, so apply Word's Heading styles before converting.

Before you start

Input: DOCX. Output: Markdown. The settings appear before anything runs, so you can check them first. Your original file is never changed.

A document conversion may not keep every font, layout rule, embedded object, subtitle cue or app-specific feature. Read through the full result before you send or submit it.

Keep the original until you have opened and checked the result. The work happens in this browser tab, so the size you can handle depends on your device's memory, your browser and the file itself.

Steps to convert DOCX to Markdown

1. Drop your .docx file into the box above, or click to pick it.
2. Press Convert. The document is read on your device.
3. Download the .md file for your docs, wiki or repo.