DOCX to Markdown Converter
Convert Word .docx files to Markdown format. Preserves headings, bold, lists, and links. Powered by Mammoth.js — your document never leaves your browser.
Also searched as: word a markdown · docx a md · documento word markdown · word to markdown · convertir word
Drop your .docx file here
or click to browse — Word documents only (.docx)
Microsoft Word remains the dominant word processor in offices worldwide, but modern development workflows increasingly rely on Markdown — a lightweight plain-text format used by GitHub, Obsidian, Hugo, Jekyll, MkDocs, and dozens of other tools. Migrating an existing library of .docx files to Markdown by hand is tedious and error-prone: you have to strip out proprietary formatting, rewrite headings, reformat lists, and fix links one document at a time. This DOCX to Markdown converter automates the entire process in seconds, giving you clean, portable Markdown output you can drop straight into any Markdown-based system.
Unlike cloud conversion services that upload your files to a remote server, this tool uses Mammoth.js — a JavaScript library that runs entirely inside your browser. Your Word document is read locally, converted in memory, and never transmitted anywhere. This makes the tool safe for confidential documents, internal reports, or any file you would rather not share with a third-party server.
Click the upload button and select your Word document (.docx) from your device.
The Markdown output appears instantly in the editor — review and edit it if needed.
Click Copy to copy to clipboard, or Download .md to save the file.
What Is This DOCX to Markdown Converter?
This is a client-side DOCX to Markdown converter built on Mammoth.js. It reads the XML structure inside a .docx file — the open standard format used by Microsoft Word — and maps each element to its Markdown equivalent. Heading styles (Heading 1 through Heading 6) become ATX headings (# to ######). Bold and italic runs become **bold** and *italic* markers. Bullet and numbered lists become - and 1. list items. Hyperlinks retain their anchor text and href. Tables are output as standard GitHub Flavored Markdown tables. Word-specific styles, comments, tracked changes, and embedded images are stripped or ignored, leaving a clean, fully portable plain-text document.
How to Use the Converter
Click the upload button and select your Word document. The file is read locally — nothing is sent to a server. Mammoth.js converts the document structure in milliseconds and displays the Markdown output in the editor panel. Review the result, make any minor tweaks directly in the editor, then copy the Markdown with the Copy button or download it as a .md file. For best results, use standard Word heading styles (Heading 1, Heading 2, etc.) rather than manually bolded or enlarged text, since Mammoth.js maps named styles — not visual formatting.
Why Convert DOCX to Markdown?
Markdown is the lingua franca of technical documentation. GitHub READMEs, wikis, and pull-request descriptions are all written in Markdown. Static site generators like Hugo and Jekyll use Markdown source files. Note-taking apps like Obsidian and Notion support Markdown import. If your team maintains documentation in Word but wants to move to any of these platforms, this converter handles the bulk conversion instantly. It also works in reverse: if you receive a .docx spec or report and need to paste excerpts into a Markdown-based system, one conversion gives you ready-to-paste content without any reformatting.
Common Use Cases
Typical use cases include: migrating a corporate knowledge base from Word to a GitHub wiki or MkDocs site; converting meeting minutes or project specs into Obsidian notes for linking and search; pulling technical documentation out of Word and into a Hugo or Jekyll static site; transforming a business requirements document into a Markdown file for a pull-request description; and moving blog drafts written in Word into a Markdown-powered CMS like Contentlayer or Astro Content Collections.
Frequently asked questions
What document elements are preserved during conversion?
Headings (H1–H6 mapped from Word's built-in heading styles), bold, italic, unordered and ordered lists, hyperlinks, and tables are all preserved with high fidelity. Word-specific styles, comments, tracked changes, footnotes, headers, footers, and embedded images are removed or simplified, as they have no direct Markdown equivalent.
Is my Word document uploaded to a server?
No. The conversion runs entirely in your browser using the Mammoth.js library. Your .docx file is read from local memory and never transmitted to any server, cloud service, or third party. It is safe to use with confidential or proprietary documents.
My headings are not converting correctly — what is happening?
Mammoth.js converts Word's named paragraph styles (Heading 1, Heading 2, etc.) to Markdown headings. If your Word document uses manually formatted text — for example, large bold text — instead of the built-in heading styles, it will not be detected as a heading. Open the Word file and apply the correct Heading styles before converting.
Can I convert tables from Word to Markdown?
Yes. Simple tables are converted to GitHub Flavored Markdown table syntax. However, complex tables with merged cells, nested tables, or custom border styling may not convert cleanly, as Markdown's table format supports only a flat row-and-column grid.
What file size limit applies?
There is no enforced file size limit. Very large documents — hundreds of pages — may take a few extra seconds to process, depending on your device's speed. For typical business documents of 10–50 pages, conversion is nearly instantaneous.