Word to Markdown Converter

Upload a .docx file, get Markdown. Keeps your headings, lists, tables, and links intact. Runs in your browser, nothing gets uploaded.

100% Free
Privacy-First
Instant Conversion

Word Document

Drop your Word document here

or click the Upload button above

Supports .docx files. All processing happens in your browser for complete privacy.

Markdown Output

Markdown output will appear here

Upload a Word document to see conversion

Getting Word Documents Into the Modern Docs Workflow

Word Is Where Content Starts, Markdown Is Where It Belongs

A lot of content still gets written in Word — meeting notes, specs, SOPs, onboarding guides. But if your documentation lives on GitHub, in a static site, or in a tool like Notion, you need Markdown. This converter bridges that gap. Upload the .docx, grab the Markdown, and you're ready to commit it to your repo. Need to go back? The Markdown to Word converter does the reverse, and there's also a Markdown to Excel converter for spreadsheet data.

Your Files Stay Private

Word documents are often sensitive — contracts, internal policies, hiring docs. The conversion runs entirely in your browser using mammoth.js and Turndown. Your .docx file never gets sent to a server, stored in a database, or logged anywhere. Close the tab and it's gone.

Smart Formatting Conversion

The tool doesn't just dump raw text. It maps Word's heading styles to Markdown headings (# H1, ## H2), converts bold and italic, preserves numbered and bulleted lists, and even handles tables. Things that don't have a Markdown equivalent — like custom fonts or text boxes — get simplified to plain text so nothing gets lost.

Scenarios Where This Saves Time

Moving Legacy Docs to GitBook or MkDocs

Most teams have a folder full of Word docs nobody can find. Converting them to Markdown and putting them in a docs-as-code system means they're searchable, version-controlled, and part of your regular workflow. I've seen teams convert 100+ docs in an afternoon this way.

Publishing Research and Papers Online

If you wrote a paper or report in Word and want to publish it on GitHub Pages or a blog, converting to Markdown is the fastest path. The headings, lists, and references all come through, and you can add syntax highlighting for code samples after conversion.

Building a Team Knowledge Base

Training manuals, process guides, onboarding checklists — these often start in Word because that's what non-technical staff are comfortable with. Convert them to Markdown and drop them into your Notion workspace, Confluence wiki, or GitHub docs repo.

Prepping Docs for Open Source Projects

You drafted a CONTRIBUTING guide or an RFC in Word because it was quick. Now you need it in the repo. Convert it to Markdown, clean up any quirks, and it's ready for a pull request. The open source world runs on Markdown, so this conversion is basically a format translation.

Frequently Asked Questions

The tool works with .docx files — that's the format Word has used since Office 2007. The older .doc format (pre-2007) isn't supported because it's a proprietary binary format that's much harder to parse in a browser. If you have a .doc file, open it in Word or Google Docs and re-save as .docx first.
Click Upload or drag your .docx file into the drop zone. The tool reads it and shows you the Markdown output right away. From there, copy it to your clipboard or download it as a .md file. The whole thing takes a few seconds.
Headings (H1 through H6), bold, italic, ordered and unordered lists, tables, links, blockquotes, and horizontal rules all come through. What doesn't translate: custom Word styles, tracked changes, comments, embedded images (they need to be hosted separately for Markdown), and fancy layout features like text boxes or columns.
Officially, 10MB. But since the conversion runs in your browser, the real limit depends on your device. A 50-page Word doc with no embedded images converts in a couple seconds on a modern laptop. A 200-page doc with lots of embedded objects might take a moment or two.
No. The file never leaves your browser. Under the hood, the tool uses mammoth.js to read the .docx format (which is actually a ZIP file with XML inside) and Turndown to convert the resulting HTML to Markdown. Both libraries run client-side.
It's a two-step process. First, mammoth.js cracks open the .docx file (which is a ZIP containing XML) and converts it to clean, semantic HTML. Then Turndown takes that HTML and produces standard Markdown. This approach gives better results than trying to go directly from Word's XML to Markdown.
Yes — use the Markdown to Word converter. It's handy when you write in Markdown but need to hand someone a .docx file for review or sign-off.
Images embedded in the Word file won't show up in the Markdown output. Markdown references images by URL, and since these images are embedded binary data inside the .docx, there's no URL to point to. You'd need to save the images separately and add Markdown image links manually.
Yes, free with no account needed. We also have Markdown to Excel, Markdown to Word, HTML to Markdown, and Excel to Markdown if you need those.