Convert Word to Markdown without uploading your document
Writers often draft in Word while wikis, static sites, and developer tools expect Markdown. This page uses mammoth to convert a .docx on your device. Headings, lists, emphasis, and links become their Markdown equivalents instead of being flattened into plain text. mammoth reads semantic styles such as Heading 1 and Normal rather than trying to reproduce the document’s appearance. Documents that use Word styles consistently produce the cleanest Markdown. Drafts and internal documents are never uploaded.
How it works
- Drop your .docx files below. Several at once is fine.
- Headings, lists, links, and emphasis are mapped to Markdown.
- Download the .md files, ready for a README, wiki, or static site.
Frequently asked questions
How good is the Markdown conversion?
Very good for well-structured documents. mammoth works from the document’s semantic styles, so real headings become Markdown headings, lists become lists, and bold/italic and links carry over. Documents that fake structure with manual font sizes instead of styles convert less cleanly. The fix is to use Word’s heading styles.
What about images and tables?
Tables are converted to Markdown tables. Images are embedded inline as data. Workable, but for a repository you will usually want to extract them to files afterwards. Highly complex layouts (columns, text boxes) flatten to linear Markdown, which is the nature of the format.
Is my document uploaded to convert it?
No. mammoth runs in your browser and reads the .docx locally, so unpublished drafts and internal documents never leave your device. It works offline once the page has loaded.
Does the old .doc format work?
No. Only the modern .docx format (Word 2007 and later). The legacy binary .doc format is not supported; open it in Word and save as .docx first, then convert here.