How to Convert Markdown to Word (Step by Step)
Microsoft Word cannot open or import Markdown on its own, so converting means turning the # headings, ** bold text and pipe tables into Word's own formatting. This page covers the four practical ways to do that, starting with the fastest. The converter on the left works for the first one: paste or upload your Markdown, check the preview, then download a .docx file or copy the formatted text into Word.
Fastest route: paste your Markdown on the left, click Download Word Doc, and open the file in Word. No install, and nothing is uploaded.
Method 1: Convert in Your Browser
This is the quickest option when you have one document and do not want to install anything.
- Open your Markdown. Paste the text into the left panel, or use the upload button for a
.md,.markdownor.txtfile. - Check the preview. Headings, lists, tables, code blocks and links appear the way Word will receive them. Fix anything odd in the editor.
- Choose your output. Download Word Doc saves a .docx file. Copy for Word puts formatted text on the clipboard so you can paste it into a document that is already open.
- Open it in Word. The .docx also opens in Google Docs and LibreOffice.
The same steps work on Windows, Mac and Linux, because nothing is installed. If your starting point is a saved file, the MD to Word page is set up for uploads.
Method 2: Copy and Paste into Word
Pasting raw Markdown into Word keeps the symbols: you see ## Heading instead of a heading and | a | b | instead of a table. To paste with formatting, put the Markdown through the converter first, click Copy for Word, and paste. Headings, lists and tables arrive as Word formatting, so you can restyle them normally.
Pasting AI chat output works the same way. There is a separate page on converting ChatGPT answers to Word with notes on equations and tables.
Method 3: Pandoc on the Command Line
Pandoc is the standard command-line converter and a good fit if you convert files regularly or script the job. After installing it, one command does the work:
pandoc input.md -o output.docx
Pandoc can also apply your own Word styles through a reference document (the --reference-doc option), which is useful when a company template has to be followed exactly. The trade-off is setup: you need to install it and be comfortable in a terminal. For a single document, a browser converter is usually quicker.
Method 4: From VS Code or Obsidian
Neither editor exports Word documents out of the box. VS Code has extensions that export Markdown, and several of them run Pandoc behind the scenes, so you still need it installed. Obsidian exports to PDF natively, and Word export usually comes from a community plugin that also uses Pandoc.
If you only need the occasional Word copy of a note, copy the text from the editor and paste it into the converter on this page. That skips the extension and the Pandoc install.
Which Method Should You Use?
| Situation | Best option |
|---|---|
| One document, no installs | Convert in your browser |
| Adding a section to a document you have open | Copy for Word, then paste |
| Many files, scripts or strict Word templates | Pandoc |
| Notes in VS Code or Obsidian | Copy the text into the converter |
What Converts and What to Check
| In your Markdown | In the Word file |
|---|---|
# Heading | Word heading style |
**bold**, *italic* | Bold and italic text |
- item, 1. step | Bulleted and numbered lists |
| Pipe tables | Word tables with a header row |
| Fenced code blocks | Monospaced code blocks |
[text](url) | Clickable hyperlinks |
Inline math such as is shown in the preview and carried into the Word file. Equations need dollar signs around them; the backslash-bracket style some tools write will not render. Diagrams are rendered in the preview, and it is worth opening the downloaded file to check them before you send it on.
Open the .docx in Google Docs
If your team works in Google Docs, download the .docx, upload it to Google Drive, and open it with Google Docs. Formatting carries across, and you can edit and share it there.
Frequently Asked Questions
Can Word open a Markdown file directly? It can open the file as plain text, but you will see the raw symbols. Convert it first to get headings, lists and tables.
Does Word have a Markdown import or export option? No. Word has no built-in Markdown import or export, which is why a converter or Pandoc is needed.
How do I convert Markdown to Word on a Mac? Use the browser method above in Safari, Chrome or Firefox. It needs no install on a Mac, Windows or Linux.
How do I paste Markdown into Word with formatting? Paste it into the converter, click Copy for Word, then paste into Word.
Is it free, and is my text uploaded? It is free with no signup, and the text is converted in your browser rather than sent to a server.
Replace this guide with your own Markdown to convert it to Word.