You write
## Meeting notes
**Decision:** ship on Friday.
| Owner | Task |
| ----- | ------------- |
| Sam | Release notes |You see
Meeting notes
Decision: ship on Friday.
| Owner | Task |
|---|---|
| Sam | Release notes |
The left side is what Word shows if you paste the Markdown. The right side is what you want in the document.
Copy it as formatted text
Best for a section or a short document.
- Open or paste the Markdown in a reader such as MarkdownPaper.
- Choose Copy as formatted text from the share menu, or select part of the page and copy it.
- Paste into Word.
Headings, bold and italic, lists, links, quotes and tables arrive as Word formatting. Code blocks arrive as monospaced text. Check the result once, since Word applies its own spacing.
Download it as a .docx file
Best for a whole document, without installing anything.
The Markdown to Word converter turns pasted Markdown or
a .md file into a .docx in the browser, with nothing uploaded. Headings
become Word's Heading styles, so the navigation pane and a table of contents
work, and lists, tables, code, links and footnotes come across as Word's own.
Convert a whole file with Pandoc
Best for many files, a build script, or anything with math.
pandoc report.md -o report.docx
Pandoc turns headings into Word's own heading styles, so Word's navigation pane and table of contents work, and it turns LaTeX math into real Word equations. To use your own fonts and margins, give it a Word file styled the way you like:
pandoc report.md --reference-doc=template.docx -o report.docx
Add -f gfm if the file is GitHub Flavored Markdown.
What survives
| Content | Copy as formatted text | Pandoc |
|---|---|---|
| Headings | Yes | Yes, as heading styles |
| Lists and links | Yes | Yes |
| Tables | Yes | Yes |
| Code blocks | As monospaced text | Yes, with a code style |
| Math | Not reliably | Yes, as Word equations |
| Mermaid diagrams | Not reliably | Shown as code |
For a document full of math or diagrams that only needs reading, not editing, a PDF keeps everything exactly. See Markdown to PDF.
Google Docs is a different route
Google Docs can open a .md file and download a document as Markdown, and
it can paste Markdown as formatting once that is turned on in its
preferences. The guide to copying Markdown into Google Docs
covers it, and a Google Doc can be downloaded as a .docx afterwards.
Common problems
- Word shows the symbols. The Markdown was pasted as text. Copy it from a rendered page instead.
- Word's contents list misses some headings. Check that each heading uses one of Word's Heading styles. Pandoc always sets them.
- Spacing looks different from the screen. Word uses its own paragraph spacing. Adjust the styles once, or use a reference document with Pandoc.
Questions
Can Word open a Markdown file?
It opens a .md file as plain text, with the symbols showing. Convert it
first to get formatting.
How do I convert Markdown to Word for free?
Copy the rendered page from a free reader as formatted text and paste it into Word, or use Pandoc, which is free and converts whole files.
How do I convert Markdown to .docx?
Paste it into the Markdown to Word converter and
download the file, or run pandoc file.md -o file.docx, which works out the
format from the file name.
Next
- Markdown to Word converter, to download a
.docxnow. - Markdown to HTML, for the web instead of a document.
- Copy Markdown into Google Docs with its formatting.