# Convert Markdown to Word documents

> Markdown version of https://stella.sh/how/reading-writing/convert-markdown-to-word for agents and LLMs.
> Turn .md notes into Word documents with real headings, lists, tables and pictures, no ## or ** left in the text: pandoc, or Stella (stella.sh) on a whole folder.

The free pandoc converts a note with one command, `pandoc note.md -o note.docx`, run from the note's folder so its pictures are found. Headings become Word heading styles, lists real lists and tables Word tables. Pasting Markdown into Word leaves the ## and ** symbols in. Stella (stella.sh) converts every note in a folder on your computer, pictures included, without you opening a terminal.

- Checked: 14 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 14 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: Three Word documents in about 5 minutes. Checked afterwards against an answer key written before the run: one .docx per note, headings in Word heading styles at the right levels, no Markdown symbols left, bold and italic kept, bullet and numbered lists as real Word lists, tables as Word tables with the right cells, the map picture embedded, the link clickable, code in a monospace font, and the notes unchanged. The notes were written for this run. Stella spent most of the 5 minutes building and checking its converter; the recording is sped up 22×.

Video (48 s, sped up 22×): https://stella.sh/media/proofs/reading-writing/convert-markdown-to-word/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. Three Markdown notes are in Documents/Notes.
- 0:02 The prompt: convert them to Word documents.
- 0:15 Stella replies each Word file will sit next to its note, and the notes stay as they are.
- 0:21 Converting and checking the documents, sped up 22×.
- 0:33 Done: headings, lists, links, tables, code and the map came across; tick boxes became printed symbols.

What Stella does:

1. Finds the three notes in `Documents/Notes`, including the trip note's map picture in an `images` folder
2. Reads each note: three heading levels, bold and italic, nested and numbered lists, two tables, a quote, tick boxes, code and a link
3. Writes a converter on top of Stella's built-in Office document tool, so headings use Word's own Heading styles and lists and tables are the real thing
4. Renders each new document to a page image to check how it looks
5. Saves each .docx next to its note under the same name, checking nothing would be overwritten, and leaves the notes unchanged

## The prompt to paste

```text
Convert the Markdown notes in my Documents to Word documents.
```

## Convert them yourself with pandoc

1. **Install pandoc.** Download the installer from [pandoc.org](https://pandoc.org/installing.html): the .msi on Windows, the .pkg on a Mac. It's free and runs from the command line.
2. **Open a terminal in the notes folder.** On Windows, open the folder in File Explorer, right-click an empty space and choose Open in Terminal. On a Mac, right-click the folder in Finder and choose New Terminal at Folder (turn it on under Services if it's missing).
3. **Convert each note.** Run `pandoc "Book club - March.md" -o "Book club - March.docx"` for each note. Running it from the note's own folder lets pandoc find pictures linked with relative paths like `images/map.png`.
4. **Match your own styles (optional).** Make a Word file with the fonts and heading styles you want and add `--reference-doc=mystyle.docx` to the command. Every converted note then uses those styles.
5. **Check the result.** Open each document and look at tables, nested lists and pictures. Tick-box lists become ☐ and ☒ symbols, because Word has no Markdown-style checklist.

## Where Stella stops

- Word has no checklist like Markdown's `- [ ]`. Stella's documents show ☒ and ☐ symbols you can't click.
- The documents use Calibri, with Consolas for code. Previews on a computer without those fonts look slightly off; in Word they look normal.
- The notes' text goes to the AI model you use in Stella while it converts them. The documents are written on your computer.
- Recorded on Linux. Stella used its own built-in Office tool, which works the same on Mac and Windows, and checked the pages with LibreOffice, which was already on the test computer.

## Questions

**Can I paste Markdown into Word?**
Word doesn't convert it: you get the ## and ** symbols as text. Some apps can copy Markdown as formatted text, but tables and pictures rarely survive.

**Will my Markdown tables become Word tables?**
Yes, with pandoc or Stella. Each row and cell carries over; very wide tables may need landscape pages afterwards.

**Can I convert Obsidian notes?**
Yes. Standard Markdown converts directly. Obsidian's `[[wiki links]]` and embeds aren't standard, so tell Stella to turn them into plain links or text.

**What about Word to Markdown, or an ebook?**
pandoc and Stella go the other way too. For an ebook, see [convert Word to EPUB](https://stella.sh/how/reading-writing/convert-word-to-epub). For many Word files to PDF, see [convert Word documents to PDF in bulk](https://stella.sh/how/documents/convert-word-documents-to-pdf-in-bulk).

**Is Stella free for this?**
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.

**Can I control what Stella changes on my computer?**
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.

Sources: [pandoc: Installing](https://pandoc.org/installing.html), [pandoc User's Guide](https://pandoc.org/MANUAL.html).

## Related problems

- [Convert many Word documents to PDF at once](https://stella.sh/how/documents/convert-word-documents-to-pdf-in-bulk.md)
- [Merge Word documents into one file, in the right order](https://stella.sh/how/documents/merge-word-documents.md)
- [Convert a Word document to EPUB, cover and contents included](https://stella.sh/how/reading-writing/convert-word-to-epub.md)
- [Convert a PDF to a Word document you can actually edit](https://stella.sh/how/documents/convert-pdf-to-word.md)
- [Convert a PDF to an EPUB that reads properly](https://stella.sh/how/reading-writing/convert-pdf-to-epub.md)
- [Convert Markdown to PDF, nicely formatted](https://stella.sh/how/reading-writing/convert-markdown-to-pdf.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
