From Markdown to Word: A Practical Guide to Pandoc on Windows 11

If you write in plain text but the rest of the world wants Microsoft Word, you have two bad options: copy-paste into Word and spend twenty minutes fixing the formatting, or keep two copies of every document and pray they stay in sync. Pandoc removes the choice entirely. Write once in Markdown, run a single command, and get a clean .docx every time. This guide walks through installing Pandoc on Windows 11, the small amount of Markdown you actually need, the conversion itself, and how to wire all of it into Obsidian so it becomes part of how you work rather than a tool you have to remember to use.

One source file, one command, a finished Word document — Pandoc turns Markdown into .docx without the copy-paste tax.

What Pandoc Is, and Why It Earns Its Nickname

Pandoc is a free, open-source command-line tool that converts documents from one format to another. Its author, John MacFarlane, calls it the swiss-army knife of document conversion, and the description is fair: it reads from and writes to dozens of formats — Markdown, HTML, LaTeX, Microsoft Word, EPUB, PDF, PowerPoint, and many more.

The mental model that makes Pandoc make sense is this. Pandoc reads your input into a single internal representation of the document — headings, paragraphs, lists, emphasis, tables — and then writes that representation out into whatever format you ask for. Because everything passes through that common middle, any input format can become any output format. You are not learning Markdown to Word as a special trick; you are learning one tool that happens to do that, along with everything else.

For most people the killer use case is the simplest one: turning a Markdown file into a Word document that a colleague, client, or examiner can open without ever knowing Markdown exists.

Installing Pandoc on Windows 11

There are three sensible ways to get Pandoc onto a Windows 11 machine. Pick one — you do not need all three.

Option 1: The MSI installer (recommended for most people)

1. Open your browser and go to the official downloads page: https://pandoc.org/installing.html.
2. Download the Windows installer — the file ends in .msi (for example, pandoc-3.8.3-windows-x86_64.msi).
3. Double-click the downloaded .msi file and follow the prompts. Accept the defaults.
4. The installer adds Pandoc to your system PATH automatically, which is what lets you type pandoc from any folder.

Once it finishes, close any open terminal windows and open a fresh one — a terminal only reads the PATH when it starts, so an already-open window will not see the new install.

Option 2: Windows Package Manager (winget)

If you are comfortable with the terminal, this is the fastest method and the easiest to keep updated. Windows 11 ships with winget built in. Open Windows Terminal or PowerShell and run:

winget install --id JohnMacFarlane.Pandoc

To update it later:

winget upgrade --id JohnMacFarlane.Pandoc

Option 3: Chocolatey

If you already use the Chocolatey package manager, a single command does it:

choco install pandoc

Confirming the install worked

Whichever route you took, open a new terminal and run:

pandoc --version

You should see something like pandoc 3.8.3 followed by a few lines of detail. If instead you get an error such as "pandoc is not recognized as the name of a cmdlet", the most common cause is that you did not open a new terminal after installing — close it and try again. If it still fails, the PATH entry is missing; reinstalling with the MSI usually fixes it.

A Quick Overview of Markdown

Markdown is a way of writing formatted text using plain characters you already type. Instead of clicking a bold button, you wrap a word in asterisks. The point is that the source stays readable as plain text and carries enough structure for a tool like Pandoc to turn it into a properly formatted document.

Here is essentially everything you need to write a real document:

A short Markdown document looks like this:

# My Report

This is the **introduction**. It explains why the report exists.

## Findings

Three things stood out:

1. The first finding.
2. The second finding.
3. The third finding.

See the [full dataset](https://example.com/data) for details.

Two formatting habits matter: leave a blank line between paragraphs (Markdown uses blank lines to separate blocks), and put a space after the # in a heading. Get those two right and almost everything else just works.

Converting Markdown to a Word Document

This is the part you came for, and it is genuinely a single line. Open a terminal in the folder containing your Markdown file (in File Explorer, type powershell into the address bar and press Enter to open a terminal already pointed at that folder), then run:

pandoc report.md -o report.docx

That is the whole thing. report.md is your input; -o means output to; report.docx is the Word file Pandoc creates. Open it in Microsoft Word and your headings are real Word headings, your lists are real lists, and your bold text is bold.

A few variations worth knowing:

Be explicit about formats (useful when file extensions are unusual). Here -f is the from format and -t is the to format:

pandoc -f markdown -t docx report.md -o report.docx

Generate a table of contents automatically from your headings:

pandoc report.md -o report.docx --toc

Match your house style with a reference document. Create a Word file styled the way you want — fonts, heading colours, spacing — save it as reference.docx, and Pandoc will apply those styles to its output:

pandoc report.md -o report.docx --reference-doc=reference.docx

This last one is the feature that turns Pandoc from a convenience into a serious tool: every document you produce can carry your exact branding, automatically, with no manual restyling.

Obsidian: Where the Markdown Lives

Writing Markdown in Notepad works, but it is not where the method comes alive. Obsidian is a free knowledge-management application that stores your notes as plain Markdown files in a normal folder on your computer — Obsidian calls that folder a vault. Because the notes are ordinary .md files, nothing is locked inside a proprietary database: you own the files, you can back them up, search them, and — crucially — feed them straight to Pandoc.

Obsidian's signature feature is linking. Type [[ and you can connect one note to another, building a web of related ideas that you can explore visually in its graph view. It is part notebook, part second brain, and it has become the default home for a lot of people who think in Markdown.

Installing the Pandoc plugin in Obsidian

Obsidian can export to Word through a community plugin that calls the Pandoc you already installed. Set it up once:

1. Make sure Pandoc is installed and pandoc --version works in your terminal (see above). The plugin drives Pandoc; it does not bundle it.
2. Open Obsidian and go to Settings (the gear icon, bottom-left).
3. Choose Community plugins. If this is your first one, click Turn on community plugins to enable them.
4. Click Browse, then search for "Pandoc". The plugin you want is Pandoc Plugin by Oliver Balfour.
5. Click Install, then Enable.
6. (Optional but recommended on Windows) In the plugin's settings, set the Pandoc path to the full path of your pandoc.exe — for example C:\Program Files\Pandoc\pandoc.exe. This avoids any "Pandoc not found" errors if Obsidian cannot see your system PATH.

Using it

Open the note you want to export and bring up the command palette with Ctrl+P. Type "Pandoc" and you will see export commands such as "Pandoc Plugin: Export as Word Document (.docx)". Select it. The plugin hands your note to Pandoc behind the scenes and drops a finished .docx next to the original note in your vault folder. The same palette offers PDF and HTML export, so the one workflow covers every format you are likely to hand someone.

The Payoff: Why Markdown and Obsidian Are Worth It

It is reasonable to ask why you would change how you write at all. The benefits compound:

Put together, the workflow is simple and durable: think and write in Obsidian, store everything as Markdown, and let Pandoc deliver whatever format the outside world demands. You learn it once, and it pays you back on every document you ever write again.