How to convert Markdown to DOCX
- Drop your Markdown files into the box above, or click it to choose from your device.
- DOCX is already selected for you. Press "Convert to Word (DOCX)".
- Download each new DOCX file, or grab them all at once as a ZIP.
Why convert Markdown to Word (DOCX)?
Markdown files are best for notes, READMEs and documentation. Word (DOCX) is the better choice for documents you still need to edit. It opens in word, Google Docs, LibreOffice and Pages, while Markdown opens in any text editor, Obsidian, GitHub.
DOCX is lossless, so nothing your Markdown file contains is thrown away on the way.
Markdown vs Word (DOCX) at a glance
| Markdown | Word (DOCX) | |
|---|---|---|
| Compression | Plain text with light markup | Zipped XML |
| Opens in | Any text editor, Obsidian, GitHub | Word, Google Docs, LibreOffice and Pages |
| Best for | notes, READMEs and documentation | documents you still need to edit |
What happens to your file
The Markdown is parsed with Marked, a fast open-source parser that follows the CommonMark and GitHub-flavoured Markdown rules. Headings, lists, links, code blocks and tables all become proper HTML, wrapped in a simple, readable page you can open in any browser.
A genuine Word document is assembled in your browser with docx, an open-source library that writes the same Office Open XML format Microsoft Word uses. Headings become Word heading styles, so the navigation pane and table of contents work, and lists, tables, links, bold and italic text are kept. Fonts and colours use Word's defaults.
Tips for a clean conversion
- Drop a whole folder's worth of Markdown files at once. They convert one after another and you can download everything as a single ZIP.
- Keep your original Markdown files until you have checked the results. Converting back later is rarely lossless.
- DOCX keeps everything it receives, so the result is only ever as good as the Markdown file you start with.
- Front matter (the YAML block some note apps put at the top of a file) is not stripped. Delete it first if you don't want it showing on the page.
- Headings become real Word heading styles, so the navigation pane and an automatic table of contents work straight away. Text uses Word's default font; restyle it in Word if you want a different look.
- There is no direct Markdown to DOCX converter that runs in a browser, so your file is passed through 1 intermediate format automatically.
About the formats
Markdown: Lightweight text formatting used by developers, notes apps and READMEs.
Word (DOCX): Microsoft Word document format.
Questions
- Is it safe to convert Markdown to DOCX here?
- Yes. The conversion runs entirely inside your web browser. Your Markdown file is never uploaded to a server, so nobody else can see it.
- Will I lose quality?
- DOCX is lossless, so nothing your Markdown file contains is thrown away on the way.
- Can I convert several Markdown files at once?
- Yes. Drop as many files as you like. Each one is converted in turn, and you can download them one by one or all together as a ZIP.
- Is it free?
- Yes. There is no sign-up, no watermark and no limit on how many files you convert.
- Does it work on a phone?
- Yes. The converter runs in any modern browser, including Safari on iPhone and Chrome on Android, so you can convert Markdown files without installing an app.