Skip to content
Markdown to Word

Markdown to Word · Notion

Notion Markdown export to Word

Notion exports a page as PDF, HTML, or Markdown & CSV. The last one is the only one that becomes an editable Word document. Paste the .md here and download a .docx with real heading styles, real checkbox bullets and real equations — and know in advance which parts of the page the export left behind.

  • Databases export as separate .csv files, so your tables are not in the .md.
  • Image paths are relative to the export folder and cannot resolve in a browser.
  • Notion has three heading levels, so the Word outline stops at Heading 3.
Untitled draft1.0 KB
1.0 KB
Preview

Quarterly Update

Paste anything here — this text is a placeholder. Nothing you type is uploaded.

What shipped

Workstream Owner Status
Billing migration Ada Done
Search reindex Grace In progress
Mobile onboarding Alan Blocked

Bold, italic, struck through and inline code all carry over into Word as real formatting, not as literal characters.

Next two weeks

Blockquotes become indented quote paragraphs.

export function total(items: readonly number[]): number {
  return items.reduce((sum, n) => sum + n, 0);
}

Footnotes become real Word footnotes.[1]

Maths (turn on “Equations”)

Inline E=mc2E = mc^2, and a display equation:

∫01x2 dx=13\int_{0}^{1} x^2 \, dx = \frac{1}{3}

Diagram (turn on “Diagrams”)

flowchart LR A[Markdown] --> B[Parse] B --> C[Render] C --> D[.docx]

  1. Numbered and positioned by Word itself, so they renumber when you edit. ↩︎

Word theme

EquationsTurns $…$ and $$…$$ into native Word equations you can edit in the equation editor. Loads an ~85 KB engine the first time.
DiagramsDraws mermaid fences and embeds them as pictures. Loads the mermaid engine the first time — 350–460 KB depending on the diagram type; fences you leave off stay as code blocks.
Fetch remote imagesOff: only data: and blob: images are embedded. With this off the converter makes no network requests, so nothing from your document leaves the tab.

Checking clipboard support…

The Markdown → OOXML converter behind this page is an open-source library called downword.

A Notion-export-shaped page to try

Copy this into the editor above and convert it. It carries the marks of a real export: a title line, database properties written as plain Name: value lines, headings that stop at ###, deeply nested bullets, a percent-encoded relative image path, a link to a .csv where a database used to be, and a dollar-delimited equation. Read the notes panel after converting — the image is the one that will be listed.

# Q3 Platform Review

Status: In review
Owner: Ada Lovelace
Last edited: 2026-08-11

## Summary

The migration landed on schedule. Remaining risk sits with the reporting
pipeline, tracked below.

### What shipped

- Billing service cutover
    - Dual-write enabled 12 July
        - Rolled back once, then re-enabled
- Search reindex
- [x] Postmortem written
- [ ] Runbook updated

![Screenshot of the dashboard](Q3%20Platform%20Review%201a2b3c4d/dashboard.png)

[Reporting backlog](Reporting%20backlog%209f8e7d6c.csv)

### Capacity

Headroom is $r = 1 - \frac{u}{c}$ across the fleet.

---

> Reviewed with the platform team on 11 August.

What a Notion export turns into

The interesting cases are all about what Markdown cannot express. Notion pages carry a lot of structure that has no Markdown syntax, and the export decides what to do with each one before this converter ever sees it.

In the sourceIn the .docxVerdict
Page titleThe first # line of the file, so the .docx already opens with a Heading 1 before your own content starts.Carries over
Database propertiesPlain 'Name: value' lines under the title, which become ordinary paragraphs. Delete them or turn them into a table if the document is going to a reader.Check it
Inline databasesNot in the .md at all — each one exports as a separate .csv and leaves a link behind. There is no table for the converter to convert.Fix it first
ImagesAn [image: …] placeholder. Paths are relative to the export folder, and the Worker has no base URL to resolve them against, so the remote-images toggle makes no difference.Fix it first
HeadingsReal Heading 1–3 styles. Notion has only three levels, so the Word outline is as flat as the Notion page.Carries over
TogglesFlattened. The title and the hidden contents both land in the document as ordinary content — nothing lost, nothing collapsed.Check it
Columns, synced blocksFlattened into sequential content in reading order. Markdown has no columns and neither does the export.Check it
Coloured text, highlightsGone. Markdown has no syntax for them, so the export drops them before the converter is involved.Fix it first
To-do checkboxesReal Word checkbox bullets, ticked and unticked as written.Carries over
$…$ and $$…$$ equationsNative, editable Word equations with the Equations toggle on — OMML, not a picture of an equation.Carries over
Nested bulletsNesting is kept to nine levels, the deepest OOXML has. Anything deeper is flattened onto the ninth and named in the notes panel.Carries over

Getting a Markdown export out of Notion

Notion can export a page as PDF, HTML, or Markdown & CSV, and only the last of those becomes something you can edit in Word. Open the page, use the •••menu at the top right, choose Export, and set the format to Markdown & CSV. A single page comes down as one .md file; a page with sub-pages comes down as a .zip holding one .mdper page plus a folder of assets, and every file name carries Notion's 32-character page id on the end. Open the .md in any text editor, copy the lot, and paste it into the editor above — or drop the file straight onto the drop zone, which reads it in your browser rather than uploading it. Convert one page at a time. The 2 MB limit here is per document and a single Notion page is nowhere near it, but a whole workspace concatenated into one file can be, and the per-page files are the natural unit anyway.

Your databases are not in the file

This is the one that surprises people. In a Markdown & CSV export, every database — inline tables, boards, calendars, linked views — is written out as a separate .csv, and the .mdkeeps only a link to it. So the tidy table sitting in the middle of your Notion page is not in the Markdown you copied, and it will not be in the Word document either: you get the database's title and a link where the table used to be. There is nothing the converter can do about that, because there is no table in its input. Only a hand-built Markdown pipe table would survive, and Notion does not produce those. If the data matters, the quickest route is to open the .csv in a spreadsheet and paste it into Word as a table once the rest has converted; the tidier route is to turn the CSV into a Markdown pipe table and paste it into the editor above with the surrounding text, so the whole document stays one file. A page that lives inside a database also gets its properties written out as plain Name: value lines under the title, and those come through as ordinary paragraphs.

Images live in a folder the browser cannot reach

Notion writes images as relative paths into the sibling asset folder that came with the export, with spaces percent-encoded — something like Q3%20Platform%20Review%201a2b3c/dashboard.png. Pasting the Markdown text on its own leaves those paths pointing at a folder your browser knows nothing about, and the conversion runs inside a Web Worker, which has no page and therefore no base URL to resolve them against, so they cannot load even in principle. Each becomes an [image: …] placeholder and a line in the notes panel. Turning on Fetch remote images does not change this, and it is worth understanding why: that toggle governs http and https URLs, and a relative path is neither. To keep an image, upload it somewhere with a real URL and swap the path before converting, or convert without it and paste the picture into Word afterwards — which, for the two or three images that actually matter on most pages, is quicker.

Three heading levels, and what that does to the outline

Notion has exactly three heading levels, so an export can only ever contain #, ## and ###no matter how deeply the page is organised. Headings become Word's real Heading 1 to Heading 3 styles here, which means the outline in Word is as flat as the outline in Notion: the navigation pane and any table of contents you insert stop at three levels. Notion also writes the page title as the first # line of the file, so the document already has a title heading before your own content starts — and if you used Notion H1s inside the page as well, the finished .docx ends up with several Heading 1s. Demote them in the editor above if you want one title and a set of sections beneath it, or leave them alone if the page really is a collection of peers. Because these are genuine Word heading styles rather than bold text, References → Table of Contents in Word builds a working contents list from them in a click; the converter does not insert one for you.

Callouts, toggles, columns and colour

Markdown has no syntax for most of what makes a Notion page look like a Notion page, and the export handles each case differently. Toggles have no Markdown equivalent, so their contents are flattened into the document — nothing is lost, but nothing stays collapsed either, and a page that read as a tidy list of toggles converts into a long one. Columns and synced blocks flatten into sequential content in reading order. Coloured text, background highlights and a callout's tint have no representation at all and simply do not appear. Where the export falls back to raw HTML for a block it cannot express in Markdown, those tags arrive in Word as visible text, because this converter escapes raw HTML rather than interpreting it — a deliberate choice, since interpreting arbitrary HTML out of a pasted document is how converters grow security holes. The preview above will not show you that happening, since a preview is a browser and browsers render HTML, so the reliable check is to search the editor for < before you convert.

What comes through untouched

Plenty survives intact, and it is worth knowing which parts you do not need to check. Bulleted and numbered lists keep their nesting up to nine levels, which is the deepest OOXML defines; anything below that is flattened onto the ninth and named in the notes panel. To-do checkboxes become real Word checkbox bullets. Quotes become Word's Quote style, dividers become horizontal rules, and code blocks keep their content and their monospace, though not their colours — the converter is passed no highlighter. Equations exported as $…$ or $$…$$become native, editable Word equations with the Equations toggle on, which is the same OMML that Word's own equation editor writes, not a picture. Bold, italic, strikethrough, inline code and links all carry over as real formatting. And none of it is uploaded: the parser and the .docx writer both run in this tab, and with remote images off the converter makes no network requests at all.

Turning a Notion page into a Word document

Export a Notion page as Markdown & CSV, paste the .md here, and download an editable Word .docx — with the databases and images handled deliberately rather than lost quietly.

  1. Export as Markdown & CSV

    Open the page in Notion, use the ••• menu at the top right, choose Export, and set the format to Markdown & CSV. A single page gives you one .md; a page with sub-pages gives you a .zip.

  2. Paste or drop the .md in

    Open the .md in a text editor and paste the whole file into the editor on this page, or drop the file onto the drop zone. It is read in your browser, not uploaded.

  3. Decide what to do about the databases

    Any database left as a separate .csv with a link in its place. Convert the CSV into a Markdown pipe table and paste it in, or add it to the Word file afterwards.

  4. Handle the images

    Relative asset paths cannot resolve, so they become placeholders. Swap in real URLs and turn on Fetch remote images, or paste the two or three that matter into Word later.

  5. Tidy the headings and convert

    Demote extra Heading 1s if you want a single title, turn on Equations if the page had any, then press Download .docx and read the notes panel.

Notion to Word: common questions

How do I export a Notion page to Word?

Notion exports a page as PDF, HTML, or Markdown & CSV. Markdown & CSV is the one that becomes an editable Word file: open the page, use the ••• menu at the top right, choose Export, set the format to Markdown & CSV, then open the resulting .md in any text editor and paste it into the editor on this page — or drop the .md file straight onto the drop zone. Press Download .docx and you have a Word document with real heading styles, real tables and real checkbox bullets.

Where did my Notion database go?

Into a separate file. In the Markdown & CSV export every database — inline tables, boards, calendars, linked views — is written out as its own .csv, and the .md keeps only a link to it. So the table you can see in Notion is not in the Markdown you copied and will not be in the Word document; you get the title and a link where the table was. If the data matters, open the .csv in a spreadsheet and paste it into Word as a table after converting the rest, or turn it into a Markdown pipe table and paste that into the editor here.

Why are the images from my Notion export missing?

Notion writes images as relative paths into the asset folder that came with the export, with spaces percent-encoded. Pasting only the Markdown text leaves those paths pointing at a folder your browser knows nothing about, and the conversion runs inside a Web Worker, which has no page and therefore no base URL to resolve them against — so they cannot load even in principle. Each becomes an [image: …] placeholder and a line in the notes panel. Turning on Fetch remote images does not help: that toggle governs http and https URLs, and a relative path is neither. Upload the image somewhere with a real URL and swap the path, or paste the picture into Word afterwards.

Why does my Word document only have three heading levels?

Because Notion only has three. Notion's Heading 1, 2 and 3 export as #, ## and ###, and there is no fourth level to export, so the Word outline is as flat as the Notion page was. Notion also writes the page title as the first # line of the file, which means a page that used Notion H1s internally ends up with several Heading 1s in Word. Demote them in the editor above if you want a single document title.

What happens to Notion callouts, toggles and coloured text?

Toggles have no Markdown equivalent, so their contents are flattened into the document — nothing is lost, but nothing stays collapsed either. Columns and synced blocks flatten into sequential content in reading order. Coloured text, background highlights and a callout's tint have no Markdown representation at all and simply do not appear. Where the export falls back to raw HTML for a block Markdown cannot express, those tags arrive in Word as visible text, because this converter escapes raw HTML instead of interpreting it. The live preview will not show you that, since a preview is a browser — search the editor for '<' before converting.

Do Notion equations convert to real Word equations?

Yes, if they exported as dollar-delimited LaTeX. With the Equations toggle on, $…$ and $$…$$ become native OMML — the same markup Word's own equation editor produces — so you can click an equation in Word and edit it rather than being handed a picture of one. The conversion engine is about 85 KB compressed and only loads the first time you switch the toggle on; if it fails to load, the equations come through as their TeX source and the notes panel says so.

This free tool is built and maintained by KSPR Technologies. We build web, mobile & AI products for clients.