Word to Markdown converter
Convert a .docx file into clean Markdown or semantic HTML with mammoth.js, and see what it could not convert.
Or choose them. Files are processed in this tab and never uploaded to any server.
Word documents are where specifications, policies and meeting notes live, and a model or a static site needs them as text with structure, not as a zip of XML and fonts. This tool uses mwilliamson/mammoth.js, which maps Word's paragraph styles to meaning — Heading 1 to #, list paragraphs to lists, tables to tables — instead of copying the visual formatting, then produces Markdown through Turndown or gives you the HTML directly. microsoft/markitdown covers the same job for PDFs, PowerPoint and Excel as a Python tool.
How it works
- Headings are only recognised when the document uses Word's heading styles; text that was merely made bold and large stays an ordinary paragraph.
- Images are left out by default to keep the output small, and can be embedded as Base64 data URIs when you need them.
- Anything Mammoth could not map, such as an unrecognised custom style, is listed at the end of the output inside an HTML comment, which Markdown renderers do not display.
Where your data goes
Nowhere. This tool runs entirely in your browser: the text you paste is processed by the page and is never transmitted to a server or written to a log.
This tool is free and needs no account. Its results exist only in your open page and are not saved anywhere.
What it costs
This tool is free, with no sign-in and no points.
Common questions
- Does it support .doc files?
- No. The old binary .doc format is a different file type from .docx, and mammoth.js only reads the Office Open XML format introduced with Word 2007. Open the file in Word, WPS or LibreOffice and save it as .docx, then convert that.
- Why did my fonts, colours and alignment disappear?
- On purpose. Mammoth keeps structure — headings, lists, tables, bold, italics, links, footnotes — and drops presentation, because Markdown has no way to express it and a model does not need it. If your document conveys meaning through colour alone, add that meaning as words before converting.
- What do the warnings mean?
- Mammoth reports each paragraph or character style it did not know how to map, such as a company template's custom heading style. The text is still there, just converted as a normal paragraph. If a warning names a heading style, the section it marks will not become a Markdown heading.
The open-source behind it
This tool runs on mwilliamson/mammoth.js, released under BSD-2-Clause. If you need the same behaviour inside your own program, that is the library to reach for.
mwilliamson/mammoth.jsAlso known as
- word to markdown
- docx to markdown
- convert docx to md
- word to html
- mammoth online