Convert Word to Markdown

Turn a Word (.docx) file into clean Markdown — headings, lists, tables and images recovered, free and entirely in your browser.

Free forever · Runs in your browser · No signup · Fidelity report included

Last verified: 2026-10-25 · engine v0.5.0 · changelog

How to convert Word to Markdown (3 steps)

1. Choose fileChoose a .docx file (no upload — it stays on your device)
2. Review warningsReview the converted Markdown and any warnings

Full workflow: going the other way with the same engine

3. Copy or downloadCopy the Markdown or download it with images in a ZIP

Example: DOCX → Markdown

A real round-trip: the .docx produced by the Markdown → Word tool (headings, table, lists, quote, code, footnote, math, image placeholder), converted back here.

Input (DOCX)
probe.docx — a Word file: Heading 1 “Quarter in review”, a bold+link paragraph, a table,
numbered and task lists, a blockquote, code, a footnote, math as text, an image placeholder.
Output (md)

Formatted rendering of the real Markdown output (source below).

Quarter in review

Revenue grew 18% — see the report.

RegionQ4
EMEA1.4M
  • first
  • second
  • ☑ audit
  • ☐ sign-off

quoted wisdom

deploy --region emea

Footnote here.[1]

E = mc^2

[image: pic]

Notes

[1] The source note.

View the exact Markdown source
# Quarter in review

Revenue grew **18%** — see [the report](https://example.com/report).

| Region | Q4 |
| --- | --- |
| EMEA | 1.4M |

- first
- second
- ☑ audit
- ☐ sign-off

quoted wisdom

deploy --region emea

Footnote here.\[1\]

*E = mc^2*

*\[image: pic\]*

## **Notes**

\[1\] The source note.

What converts natively (and what doesn't)

FeatureResult in the Markdown
Heading 1–6 stylesNative — Reproduced as # through ######
Bold, italic, strikethroughNative — **strong**, *em* and ~~struck~~ in the output
HyperlinksNative — [text](url) — https and mailto
Bulleted and numbered lists, incl. nestingNative — Standard Markdown list syntax from real Word numbering
ImagesNative — Extracted into a media/ folder inside the ZIP, referenced with relative paths
Simple tablesNative — GitHub-flavored pipe tables
Complex / merged-cell tablesPartial — rowspan/colspan expand into the grid — columns stay aligned, covered cells empty (GFM has no merge syntax)
Text boxesPartial — Best-effort extraction of text outside the main flow
Tracked changesPartial — Accepted-changes semantics: insertions kept, deletions dropped — Markdown has no revision-mark concept
Word “Quote” style blockquotesNative — Quote / Intense Quote / Block Text styles map to > quotes; unstyled indents stay plain paragraphs
Headers, footers, page numbersNot supported — Dropped — they are layout, not content
Legacy .doc filesNot supported — Rejected with a clear message — save as .docx first

Full element-by-element ground truth, with test dates: format support.

What this tool does not do

  • No: Legacy binary .doc files — only modern .docx is read
  • No: True merged cells — rowspan/colspan expand into the grid (covered cells empty); Markdown has no cell-merge syntax
  • No: Headers, footers, page numbers and TOC fields — layout, not content
  • No: Comments and revision history

What people use Word to Markdown for

Docs-as-code migrationMove policy docs, specs and manuals out of Word attachments and into Git — versioned, diffable and reviewable in pull requests instead of email chains.
CMS and blog publishingConvert a client's Word draft into clean Markdown for WordPress, Ghost or a static site generator — headings and tables survive, tracking markup does not.
Knowledge-base importsFeed Obsidian, Notion or a wiki from existing Word documentation; images are extracted into a media/ folder with relative references.

Frequently asked questions

Are images recovered?

Yes. Images embedded in your Word file are extracted and packaged into a ZIP alongside the .md file, referenced with relative paths.

Are legacy .doc files supported?

No — only modern .docx files. Legacy .doc, encrypted and macro-enabled documents are rejected with a clear message.

How are tracked changes handled?

The converted output reflects the text as it appears in the document; revision marks, comments and version history are not Markdown concepts, so they are not carried over.

What about complex tables or text boxes?

Simple tables convert well. Merged cells expand into the grid with covered cells empty (Markdown has no cell-merge syntax), and text-box content is best-effort — anything approximate is listed in the warnings before you export.

Is my Word file uploaded to a server?

No. The .docx is parsed inside your browser and your data never touches a network — the same architecture as every DocsFast tool. Open DevTools with the Network tab visible and convert: watch no request carry your file.

Which Word features map to which Markdown?

Heading styles become # headings, bold and italic become ** and *, real Word numbering becomes numbered lists, tables convert to GFM pipes, and embedded images are extracted into a media/ folder inside the ZIP rather than uploaded anywhere.

Why is a heading missing from my output?

Word only maps to Markdown when true styles are used: text that is simply large and bold — without the Heading 1 style — converts as a plain paragraph. Apply real Word styles in the source document first.

Why convert Word to Markdown at all?

Because Word files do not diff, review or publish well. Markdown drops into Git, static site generators, wikis, Obsidian and Notion — and it is the format AI tools read most reliably. This converter recovers the structure from a .docx so you do not retype it.

Can I use the output in GitHub or a static site generator?

Yes. The output is GitHub-flavored Markdown: headings, lists, pipe tables and fenced code that paste cleanly into README files, pull requests, Jekyll, Hugo, Astro and most CMS editors.

Will complex formatting carry over exactly?

No — and that is by design. Markdown has no concept of fonts, colours or page layout, so what carries over is structure: headings, emphasis, lists, tables, links, images and code. Anything approximate is flagged in the warnings before you export.

Related tools

Related searches: markdown to word · html to markdown · markdown to pdf