SwitchPDF

Word to Markdown

Convert a Word .docx into GitHub-Flavored Markdown — headings, lists, tables and links preserved.

Convert a Word document (.docx) to GitHub-Flavored Markdown online free. Powered by Pandoc, so headings, lists, tables, links, and inline formatting come across cleanly. Copy the Markdown or download the .md file — perfect for moving content from Word into a README, docs site, or static blog.

Modern .docx files only (legacy .doc is not supported). Powered by Pandoc, so headings, lists, tables, and links convert cleanly. Only convert files you own or have permission to use.

How Word to Markdown works

Word documents carry real structure — heading styles, lists, tables, links, emphasis — so unlike PDF, a .docx converts to Markdown faithfully. This tool runs Pandoc, the gold-standard open-source document converter, with the GitHub-Flavored Markdown target, the same dialect GitHub, GitLab, and most static-site generators expect.

Heading 1–6 styles become `#`–`######`, bold and italic become `**`/`*`, bulleted and numbered lists become Markdown lists, hyperlinks become `[text](url)`, and Word tables become GFM pipe tables. The result is clean, portable Markdown you can drop straight into a README, a Docusaurus/MkDocs/Hugo site, a wiki, or a blog CMS.

This is the reverse of our Markdown-to-DOCX tool, and together they let you round-trip content between the Word world (where clients, editors, and non-developers work) and the Markdown world (where developers and docs live). Common uses: turning a client's Word brief into Markdown for your repo, migrating documentation out of Word into a static site, or extracting a draft written in Word into your blog's Markdown pipeline. Note that only the modern .docx format is supported — legacy binary .doc files must be re-saved as .docx first.

How to use Word to Markdown

1

Upload your .docx

Drop in a modern Word .docx file. It is processed in memory and deleted after conversion.

2

Pandoc converts it

The document is converted to GitHub-Flavored Markdown — headings, bold/italic, lists, tables, and links are preserved.

3

Copy or download

Copy the Markdown in one click or download the .md file, ready for your repo or docs site.

Frequently Asked Questions

Does it preserve headings, lists, and tables?
+
Yes. Because Pandoc reads the real document structure in a .docx, headings, bold/italic, bulleted and numbered lists, links, and tables all convert to proper GitHub-Flavored Markdown.
What Markdown flavor is the output?
+
GitHub-Flavored Markdown (GFM) — the dialect used by GitHub, GitLab, and most static-site generators, including pipe tables and fenced code.
Does it support the old .doc format?
+
No — only modern .docx (Office Open XML). If you have a legacy .doc, open it in Word or Google Docs and "Save As" .docx first, then convert.
What happens to images in the document?
+
Text, headings, lists, tables, and links convert to Markdown. Embedded images are not exported inline — add them back by reference if you need them.
Can I copy the Markdown directly?
+
Yes. The converted Markdown appears in an editable box with a one-click "Copy Markdown" button, and you can also download the .md file.
Is my document private?
+
The .docx is processed in memory and deleted right after conversion; the output .md is removed automatically after 15 minutes. Nothing is logged or shared.
Is Word to Markdown free?
+
Yes — completely free, no sign-up, no watermark. Fair-use rate limits apply per visitor.

Related tools

JSON Converter

Convert JSON / arrays to Excel, CSV or PDF

JSON to Excel

Convert JSON / API data to an Excel .xlsx file

API Response to Excel

Turn a REST API JSON response into Excel or CSV

Markdown to DOCX

Live MD preview, export to Word .docx

PDF to Markdown

Extract PDF text into clean Markdown

Edit PDF

Edit text, add signatures & shapes, white-out