DOCX to Markdown Converter
Turn Word documents into clean GitHub-flavoured Markdown, with tables, links and images.
Convert your document
Converted on our serverHow it works
- Choose a .docx fileDrop in a Word document up to 20 MB.
- Agree and convertConfirm the upload and press Convert.
- Copy or downloadCopy the Markdown from the page, or download the .md file (a ZIP when there are images).
Supported formats
Any of these can be converted into any other. Old .doc files and PDFs are not supported.
About this tool
Markdown is what README files, documentation sites, Obsidian and many notes apps use, but drafts often start in Word. This converter turns a .docx file into GitHub-flavoured Markdown: headings become # lines, bold and italic become ** and *, and lists, links, tables and footnotes are kept. A table that Markdown cannot express, such as one with merged cells, stays as an HTML table, which GitHub and most Markdown viewers display.
If the document contains images, you get a ZIP file with the .md file and a media folder, and the Markdown links point into that folder. Tracked changes are accepted, so you get the final text; comments, headers and footers are left out. The conversion runs on our server with Pandoc after you agree to the upload, and your file is deleted as soon as the result is ready.
Questions people ask
Which Markdown flavour do I get?
What happens to images?
Are tracked changes and comments included?
Can I convert an old .doc file?
Getting clean Markdown from Word
Style headings in Word first
Only paragraphs that use Word's Heading styles become # headings. Fix the styles in Word before converting and the Markdown outline comes out right.
Simplify merged table cells
Markdown tables cannot merge cells, so those tables stay as HTML. Split merged cells in Word if you need a plain Markdown table.
Keep the media folder beside the file
Images are linked as media/ paths next to the .md file. If you move the images elsewhere, find and replace that path in the Markdown.
DOCX vs Markdown
| DOCX | Markdown | |
|---|---|---|
| Full name | Microsoft Word document (Office Open XML) | Markdown plain-text formatting (GitHub flavour) |
| Formatting it keeps | Everything: styles, fonts, tables, images, headers, comments and page layout | Headings, bold and italic, lists, links, images, tables and code; no fonts or page layout |
| Best for | Documents people edit, review and send by email | README files, documentation, notes apps and static websites |
| Works with | Word, Google Docs, LibreOffice, Pages and most upload forms | GitHub, GitLab, Obsidian, Notion, Jekyll, Hugo and any text editor |