---
title: "Markdown to Word on a Mac, with headings and tables that stay editable"
author: Pedro Thomaz
source: https://coffeetext.app/blog/markdown-to-word-docx-mac
---

# Markdown to Word on a Mac, with headings and tables that stay editable

> Checked November 2026 on macOS 26, against the Pandoc manual linked below. Coffee isn't affiliated with Pandoc.

You write in Markdown and the person you're sending it to wants a Word file. A PDF won't do, because they'll edit it. So the Word file needs to be a real one: headings that are Word headings, lists that are Word lists, a table they can add a row to.

## With Pandoc

[Pandoc](https://pandoc.org/MANUAL.html) is the standard converter, and it runs in Terminal. Install it with Homebrew, then:

```
brew install pandoc
pandoc notes.md -o notes.docx
```

Headings become Word's heading styles, so the navigation pane and a table of contents work. Lists, tables, links, footnotes and pictures come across.

To make the file look like your organisation's documents, give Pandoc a Word file to copy its styles from:

```
pandoc notes.md --reference-doc=house-style.docx -o notes.docx
```

Pictures are found relative to where you run the command, so run it from the note's folder. Maths is converted to Word's own equations.

## From Coffee

Coffee exports Word itself, so there's nothing to install:

1. Open the note and press ⌘E, or choose Note › Export….
2. Choose Word.
3. Choose where to save the file.

The file has real headings, lists, tables, links and pictures, so it's easy to keep editing in Word or Pages. Formulas, diagrams, callouts and footnotes carry into the export too.

If the note has sums, the Word file has the answers you see written in: a line `north + south` with 200 beside it reads `north + south = 200`. Your note itself keeps the sum as you wrote it.

The same panel exports PDF, EPUB, HTML, RTF, OpenDocument, LaTeX and the rest.

## Check before you send

Open the file once before it goes:

- **Headings.** Click one and look at the style name. It should say Heading 1 or Heading 2, not Normal in bold.
- **Pictures.** A missing picture usually means a broken path in the note, so check each one arrived.
- **Tables.** Wide tables can run off the page in portrait. Turn the page to landscape in Word, or split the table.
- **Fonts.** Word uses its own default fonts unless your converter brings a style.

## Going back

When the file comes back with changes, you'll want it in Markdown again. [Converting Word to Markdown](https://coffeetext.app/blog/word-google-docs-to-markdown) covers that, and for a few changed paragraphs, copying them across by hand is often quicker.

## Questions

### Can Word open a Markdown file?

It opens it as plain text, with the asterisks and hash signs showing. To get formatting, convert the Markdown to .docx first.

### Does the Word file keep my tables?

Yes, with both Pandoc and Coffee's export. They arrive as Word tables you can edit.

### What happens to maths?

Pandoc turns TeX maths into Word equations. Coffee's export carries formulas into the Word file as well.

### Is there a way without Terminal?

Yes. Coffee exports Word from Note › Export…, and doesn't use Pandoc, so there's nothing else to install.

---

Written by Pedro Thomaz, who makes Coffee, a Markdown editor for the Mac on macOS 15 or later, and for iPhone and iPad. It's free for 14 days with no card or account, then €3 a month, €29 a year, or €79 once with two years of updates. More at https://coffeetext.app/llms-full.txt
