Word to Markdown

What this tool does

It converts a Word .docx file into Markdown in your browser using the mammoth library. Headings, paragraphs, bold and italic text, links and lists are converted, and you can copy the result or download it as a .md file. The document is not uploaded.

How to use it

1. Choose a .docx file.
2. Click Convert to Markdown.
3. Copy or download the Markdown and review it before you publish.

What to expect

• A paragraph with a heading style becomes a line starting with #. Lists become list items.
• Bold is written with double underscores, as in __word__. This is valid Markdown and renders like **word**. Use find and replace if you prefer asterisks.
• Characters that Markdown treats as special are escaped with a backslash, which is correct but can look noisy. The tool removes the unnecessary escapes before full stops, except where a number followed by a full stop at the start of a line needs one to avoid starting a numbered list.

Limits

• Basic structure only. Complex tables, merged cells, text boxes and multi-column layouts do not map onto Markdown. Review the output, especially tables.
• Heading detection depends on styles. A "heading" made by enlarging bold text will come out as a normal paragraph.
• Images are embedded inline as data, which can make the file large. Replace them with links to image files if the Markdown is for a repository or a website.
• Only .docx. Save older .doc files as .docx first. Password-protected files are not supported.

Next steps

Run the output through the Markdown formatter to tidy heading spacing and blank lines. If you need the plain text only, use Word to Text, and for web markup use Word to HTML.