Word to Markdown Converter
Drop a .docx file and get Markdown ready for GitHub or your docs site.
How the Word to Markdown Converter works
The document is read by Mammoth, which maps Word styles to semantic HTML (Heading 1 becomes h1, list styles become lists, bold and italic stay as emphasis), and the HTML is then converted to Markdown. Because it keys off style names, documents that use real heading styles convert much better than those that just make text big and bold.
Embedded pictures are not copied; a placeholder marks where each image was. The tool shows any warnings from the converter, such as an unrecognized style, so you know what to check by hand.
Word to Markdown Converter examples
Convert Word document tables and copy into Markdown
Input
[Word .docx document content]
Result
# Overview Convert text easily using browser-based tools. | Tool | Category | | --- | --- | | Case Converter | Text |
When it is useful
- •Moving documentation from Word to a Git repository.
- •Publishing a draft to a static site or a Markdown based CMS.
- •Cleaning a document for use in a note taking app.
- •Extracting structured text from a report.
Frequently Asked Questions
Does it support the older .doc format?
No, only .docx. Open a .doc file in Word and use Save As to create a .docx first.
Why are my headings plain text?
The document probably uses manual formatting instead of Word's Heading styles. Apply real heading styles in Word and convert again.
Is my file uploaded?
No. It is processed in your browser.
Guides that use this tool
Related tools
- PDF to Markdown ConverterDrop a PDF and get structured Markdown back.
- Markdown FormatterTidy a Markdown document so that lists, tables and spacing are consistent.
- HTML to Markdown ConverterPaste HTML and get Markdown you can drop into a README, a wiki or a static site.
- Plain Text ConverterNormalize text copied from Word, web pages and chat apps into simple characters that work everywhere.