To turn a .md file into a Word document, convert it first, because Word doesn't understand Markdown and shows a .md file as plain text full of # and ** symbols. The one-step way is One Clear Reader's Save as Word, which keeps real headings, tables and diagrams (free to try for 30 days). The free route is Pandoc, one Terminal command: pandoc file.md -o file.docx, or import the .md into Google Docs and download it as Word.
Can't I just open the .md file in Word?
You can open a .md file in Word, but you won't get a formatted document. Markdown isn't in the list of file formats Word supports (Microsoft Learn), so the best Word can do is treat the file as plain text, symbols and all.
Pasting has the same problem. Copy the text of a .md file into Word and the # and ** come with it. Word's paste options keep or drop formatting, but none of them reads Markdown (Microsoft Support). If your text is sitting in a chat window rather than a file, how to paste AI text into Word has faster fixes.
Microsoft's OneDrive and SharePoint now show and edit .md files formatted in the browser (Microsoft, April 2026). That's a viewer and editor for the .md itself. It doesn't turn it into a Word document.
So you need a converter. Here are the real options.
Which converter should I use to turn a .md file into Word?
Pick the converter by what's in the .md file and whether you're comfortable in Terminal. This table compares six routes on effort, Word headings, tables, pictures, diagrams and cost.
| Method | Effort | Real Word headings | Tables | Pictures | Diagrams | Cost |
|---|---|---|---|---|---|---|
| One Clear Reader, Save as Word | One menu command | Yes. | Yes. | Yes. | Yes. as pictures | Free for 30 days, then Pro |
| Pandoc | Install once, then one Terminal command | Yes. | Yes. | Yes. if they're in the file's folder | No. they stay as code | Free |
| Typora | Install Typora and Pandoc, then a menu command | Yes. it uses Pandoc | Yes. | Yes. | Yes. per Typora's docs | $14.99 once, plus Pandoc |
| Google Docs import, then download | Upload, then download | Partly. Google converts headings on import | Not promised in Google's help | Not promised | No. | Free with a Google account |
| Ask Claude to make the .docx | One message, then download | Varies, check it | Varies | Varies | Varies | Included in Claude plans |
| Open the .md in Word | Double-click, then clean up by hand | No. | No. | No. | No. | Free if you have Word |
Typora's price checked 28 September 2026.
"Real Word headings" matters more than it sounds. It means the headings use Word's Heading 1 and Heading 2 styles, and only headings with those styles show up in Word's Navigation pane (Microsoft Support). Big bold text that only looks like a heading gives the reader no outline to jump around with.
How do I save a .md file as Word in One Clear Reader?
To save a .md file as Word in One Clear Reader, open it and choose File › Save as Word…. It's also in the More menu and in ⌘K. Pick where to save and you're done.
What you get (Pro) is a real .docx built from the page you're reading:
- Word headings, so the Heading styles and navigation work.
- Lists and tables as real Word lists and tables.
- Links that still click.
- Pictures from the .md's folder.
- Diagrams as pictures, so a Mermaid flowchart arrives as a drawing, not a block of code.
- Math as one line of text.
The page size follows your Mac: US Letter if your Mac is set to US or Canadian English, A4 otherwise.
Save as Word doesn't convert PDFs or Word files (those are already documents). For a PDF of the same file, see how to turn a .md file into a PDF.
How do I convert a .md file to Word free with Pandoc?
To convert a .md file to Word for free, use Pandoc, a converter that runs in Terminal. Some apps, Typora included, use it behind the scenes.
- Install it. Download the Mac installer from pandoc.org, or type
brew install pandocin Terminal if you use Homebrew (Pandoc install guide). - Go to the file's folder. In Terminal, type
cd(with a space at the end), drag the folder from Finder onto the Terminal window, and press Return.cdmeans "change directory", which is Terminal's word for folder. - Convert:
pandoc plan.md -o plan.docxThat's it. plan.docx appears in the same folder.
Why step 2 matters: Pandoc looks for pictures starting from the folder you're in (Pandoc manual). Run it from the file's own folder and images linked in the .md come along.
Two extras worth knowing:
- Use your company's Word styles. Pandoc's
--reference-docoption takes a Word file and uses its styles, margins, page size, header and footer. The manual suggests starting from Pandoc's own default reference file and changing its styles to match your template. Then runpandoc plan.md --reference-doc=template.docx -o plan.docx. - Diagrams stay as code. Pandoc doesn't draw Mermaid on its own. A community add-on, mermaid-filter, can, but it needs Node.js and more setup. If your file has diagrams, one of the other routes is easier.
How do I export a .md file to Word with Typora?
Typora can export a .md file to Word, but only after you install Pandoc. The menu is File › Export › Word (.docx) (Typora support).
Typora's docs say diagrams it draws are included when you export to .docx (Typora support). That makes it a good middle ground if you want Pandoc's output without Terminal, and you also want a writing app.
How do I turn a .md file into Word with Google Docs?
To turn a .md file into Word with Google Docs, import the .md, then download it as a Word file. No install needed.
- Choose
File › Openin Google Docs, click Upload, and pick your .md file (Google Docs Help). - Check the result. Fix anything that didn't convert.
- Choose
File › Downloadand pick Microsoft Word as the file type (Google Docs Help).
Google's help page lists headings, bold, italic, strikethrough and links as the Markdown it handles. It doesn't promise tables, pictures or diagrams, so look at those carefully before you send the file. You also end up with a copy in your Google Drive, which is either handy or one more place for versions to drift.
Can Claude make the Word file for me?
Often, yes: Claude can create Word documents you download, once "Code execution and file creation" is on in Settings › Capabilities (Claude Help Center). Ask it to "turn this into a Word document" and download the result.
This is quick for one-off documents. The catch is that you're trusting the AI to rebuild the document faithfully. Open the .docx and check the tables and numbers before it goes to anyone important.
What do I do when someone sends back a Word file?
When someone sends back a Word file, you have a .docx with their changes and a .md your AI works from. You have three ways to deal with them.
Edit the Word file itself. Word does this best. Without Word, Pages imports Word documents (Apple), and TextEdit opens and saves Word format and comes with every Mac (Apple Support). Fine for small changes.
Edit the words in place in One Clear Reader (Pro). Open the .docx, press ⌘E, and change the words in any paragraph or table cell. You can switch a paragraph between Normal text, Title, Heading 1 to 4 and Quote, if the file has those styles. When you press ⌘S, only the paragraphs you changed are rewritten, and a backup of the original is kept first.
One Clear Reader's Word editing is built for fixing words, not redesigning the document. You can't add new paragraphs or toggle bold and italic, and paragraphs with pictures, comments or text boxes stay locked. Files with tracked changes or comments, or files open in Word, stay read-only.
Turn it back into Markdown (Free). Choose Edit a copy as Markdown. One Clear Reader saves a .md beside the Word file, with its pictures in a _files folder, and opens it for editing. The Word file isn't touched. Now your AI can read their version, and you can ask it what changed.
How do I stop ending up with five versions of the Word file?
To stop ending up with five versions, pick one file as the master: the .md while your AI keeps working on it, the Word file once other people are editing it in Word. What goes wrong is editing both. How to send a .md file to someone who's never seen one has the full routine, including dated copies.
Questions people ask
Can Microsoft Word open a .md file?
Word can open a .md file as plain text, but it won't format it. Markdown isn't one of Word's supported file formats, so headings, bold and tables show up as # and ** symbols. Convert the file to .docx first.
What's the free way to convert Markdown to Word on a Mac?
Pandoc is the free way to convert Markdown to Word on a Mac. Install it from pandoc.org or with brew install pandoc, then run pandoc file.md -o file.docx in the file's folder. Importing into Google Docs and downloading as Word also works, with less control over tables.
Why did my diagram turn into code in Word?
A diagram turns into code in Word when the converter doesn't draw Mermaid diagrams. Pandoc and Google Docs leave them as code. One Clear Reader's Save as Word puts them in as pictures, and Typora's docs say its .docx export includes diagrams.
Does Typora need Pandoc to export to Word?
Yes. Typora exports PDF and HTML on its own, but Word export only works once Pandoc is installed.
Can I edit a Word file without Microsoft Word on a Mac?
Yes. TextEdit opens and saves Word files, and Pages imports them. One Clear Reader can change the words in a Word file in place (Pro), or save an editable Markdown copy for free.
Will the Word file from a .md be A4 or Letter?
With One Clear Reader, the Word file's page size follows your Mac's language: US Letter for US or Canadian English, A4 otherwise. With Pandoc it follows the reference document you give it.