About
What is WordToMD?
A free, private Word-to-Markdown converter that runs entirely in your browser. No upload. No account. No waiting.
Our Mission
WordToMD exists to solve a specific, common problem: getting content out of Word documents and into Markdown without manual formatting work. Whether you're a developer writing documentation, a writer maintaining a blog, or an organization migrating a knowledge base — the Word-to-Markdown conversion step shouldn't be painful.
How It Works
WordToMD is powered by two excellent open-source libraries:
- mammoth.js — Reads .docx files in the browser via the FileReader API and converts them to clean HTML, mapping Word styles (Heading 1, Heading 2, etc.) to their HTML equivalents.
- turndown — Converts the HTML output from mammoth into standard Markdown, with custom rules for tables (GitHub Flavored Markdown), code blocks, and other elements.
The entire pipeline runs inside your browser tab. The file is read using the
FileReader API, never transmitted over the network.
Privacy First
Many document conversion tools require you to upload your file to a server. That means your content — potentially confidential reports, client documents, internal knowledge base articles — passes through someone else's infrastructure.
WordToMD is architecturally different: the conversion logic runs in JavaScript in your browser tab. The file bytes never leave your device. You can verify this by opening your browser's Network tab (F12) before converting — you will see zero file upload requests.
What Gets Preserved
The following Word elements convert reliably:
- Headings (H1–H6) → ATX-style Markdown headings
- Bold (**text**) and italic (_text_) formatting
- Ordered and unordered lists, including nested lists
- Tables → GitHub Flavored Markdown table syntax
- Hyperlinks with anchor text
- Monospace / code-styled text
- All Unicode characters (Chinese, Japanese, Arabic, emoji, etc.)
Known Limitations (V1)
Some Word features don't have Markdown equivalents:
- Merged table cells are simplified to adjacent columns
- Embedded images produce a conversion note (image handling is V2)
- Text boxes and SmartArt are not supported
- Custom paragraph styles map to the nearest standard equivalent
- Track changes / comments are stripped (only final content is converted)
When mammoth detects elements it can't fully convert, the "Conversion Notes" panel in the results view will list them so you can review manually.
Built With
WordToMD is built with Astro 6, Tailwind CSS 4, and deployed on Cloudflare Workers. The blog is powered by Astro Content Collections.