DOCX to Markdown
Convert Word documents to Markdown for free — headings, bold and italic text, bulleted and numbered lists, links, tables and images are turned into clean Markdown. Download images as separate files in a ZIP or embed them, choose your Markdown style, and preview the result. Runs privately in your browser.
100% private — everything runs in your browser. Conversion happens on your device; nothing is uploaded.
Word headings, bold, italics, lists, links, tables and images are converted with the open-source mammoth and Turndown libraries. Colours, fonts and page layout aren’t part of Markdown, so they’re left out. Your document never leaves your device.
How to convert Word to Markdown
- Drop your .docx file in the box.
- Choose how images are handled.
- Check the Markdown and preview, and adjust styles.
- Download the .md file (or a ZIP with images), or copy it.
What you can use it for
- Publish Word documents on GitHub, docs sites and wikis
- Move content into Obsidian, Notion and static-site generators
- Hand documents to developers in a version-control-friendly format
- Feed clean text to AI tools
More free tools
Building for the web?
Format, minify, convert and generate code with our free, private developer tools.
See all free tools →Frequently asked questions
How do I convert Word to Markdown?
Drop the .docx file in. The Markdown appears with a live preview — download it or copy it.
What happens to images?
Choose “Separate files” to get a ZIP with the Markdown and an images folder, or “Embedded” to keep everything in one .md file.
Does it work with .doc files?
Only .docx. Open older .doc files in Word or Google Docs and save them as .docx first.
Is my document uploaded?
No. It's converted on your device.
Should I choose separate image files or embedded images?
Separate files is the default: the download is a ZIP named after your document, holding the .md file and an images folder (image1.png, image2.jpg and so on) that the Markdown links to. Embedded writes each image into the .md file as base64 data, so you get one self-contained but larger file. A document with no images downloads as a plain .md either way. If you change this setting, drop the document in again.
Which Word formatting is converted?
Headings, bold, italic and strikethrough text, bulleted and numbered lists (including nested lists), links, tables and images are converted. Bold becomes **text**, italic becomes *text* and strikethrough becomes ~text~, using GitHub-flavoured Markdown. Any alt text you added to an image in Word is kept as the image description in the Markdown.
How are Word tables converted?
Each Word table becomes a GitHub-flavoured Markdown pipe table, with | between cells and a — line under the header. Markdown tables need a header row, so the first row of each table is used as the header. Bold, italic and links inside cells are converted too. Check the Preview panel to see the table before you copy or download the Markdown.
What do the Headings, Bullets and Links options do?
Headings switches between # (ATX) headings and underlined (Setext) headings. Setext only applies to the top two levels, so levels 3 to 6 still use # marks. Bullets sets the list marker to -, * or +. Links chooses inline links, [text](url), or reference-style links, [text][1], with the numbered URLs listed at the end. Changes apply straight away, without dropping the file again.
Why didn't my headings turn into Markdown headings?
Only paragraphs that use the Heading 1 to Heading 6 styles become Markdown headings, from # to ######. Lines that are just bold or set in a larger font, or that use the Title style, come through as ordinary paragraphs. Apply a Heading 1 to Heading 6 style to those lines in your document, save it as .docx, then drop it into the tool again.
Why does it say some formatting details couldn't be carried over?
The status line counts the warnings the converter raised. They come from things like a paragraph or character style it doesn't recognise, such as a custom style, which is then converted without that style, or an image type that may not display in web browsers. Your document is still converted, so compare the Preview with the original to spot anything you want to fix by hand.
What happens to footnotes and endnotes?
They're kept. Each footnote or endnote reference becomes a number in square brackets, such as [1], in the text, and the note text is collected into a numbered list at the end of the Markdown. Footnotes and endnotes share one numbering sequence, in the order they appear. Check the Preview to see how they read before you copy or download the Markdown.
Can I edit the Markdown before I download it?
Yes. The Markdown box is editable, and Download and Copy Markdown both use whatever is in the box, including your changes. The Preview doesn't refresh as you type, though. Changing the Headings, Bullets or Links option rebuilds the Markdown from your document and replaces any edits, so pick those settings first, then make your changes.