MarkdownPDF

Word to Markdown Converter

Drop a .docx and get clean Markdown — headings, lists, tables, links and, if you want them, images. Free, and the document is converted in your browser, never uploaded.

Images in the document
Select Word file

Drop a Word .docx file here

Your file never leaves your device

Why convert Word documents to Markdown?

A .docx is a ZIP of XML files full of styling that only Word understands. Markdown is plain text with just enough structure: it goes into Git and shows a readable diff, publishes to static-site generators and wikis, and it is the format language models read best — see why LLMs prefer Markdown. Converting a handbook, a spec or a set of meeting notes once gives you a version you can edit anywhere.

How to convert a Word document to Markdown

  1. Drop a .docx file on the converter above, or click to choose one. Google Docs users can download their document with File → Download → Microsoft Word first.
  2. Choose what happens to images: leave them out, save them to an images/ folder next to the Markdown (downloaded together as a ZIP), or embed them in the file itself.
  3. Read the Markdown in the preview, then copy it or download the .md file — ready for GitHub, Obsidian, a static-site generator or a prompt.

What converts, and how

  • Heading 1 to Heading 6 styles → # to ###### headings.
  • Bulleted and numbered lists → Markdown lists, nesting included.
  • Tables → GitHub-flavored pipe tables, with the first row as the header.
  • Bold, italic and strikethrough → **bold**, *italic* and ~~strikethrough~~.
  • Hyperlinks → [text](url); footnotes → a numbered list at the end, linked from the text.

Getting a clean result

The converter follows the document's structure, so the better the Word file uses styles, the better the Markdown. Real Heading styles become # headings; real lists become Markdown lists; a Word table becomes a Markdown table whose first row is used as the header. Merged cells and tables nested inside tables have no Markdown equivalent, so those tables need a look after conversion.

Word to Markdown with pandoc

On the command line, pandoc input.docx -t gfm -o output.md does the same job and is the better choice for converting a whole folder in a script; add --extract-media=images to save the pictures. For one document at a time, the converter on this page needs no install, and like pandoc it keeps the file on your machine — unlike most online Word to Markdown converters, which upload it to a server.

From Markdown back out

Once the content is in Markdown, you can turn it into a PDF or a web page. For PDFs you received rather than wrote, go the other way with PDF to Markdown. The trade-offs between the three formats are in PDF vs Word vs Markdown.

Frequently asked questions

Still stuck? Ask us.

What survives the conversion?

Headings (when the document uses Word's Heading styles), bold, italic, strikethrough, links, bulleted and numbered lists, tables, footnotes and images. Fonts, colours, page layout, headers and footers are dropped — Markdown has no way to express them, and that is usually the point of converting.

My headings came out as bold text. Why?

Because in the Word file they are bold text: someone made them bigger and bolder by hand instead of applying the Heading 1 / Heading 2 styles. The converter reads structure, not appearance. Apply the heading styles in Word (or Google Docs), save, and convert again.

Does it work with old .doc files?

No — only .docx, the format Word has used since 2007. Open a .doc in Word, LibreOffice or Google Docs and save it as .docx first. The tool recognises a .doc and tells you so rather than failing silently.

What happens to images?

You choose. Leave them out for text-only uses such as ChatGPT or a wiki; save them to a folder, which downloads a ZIP with the .md file and an images/ folder referenced by relative links; or embed them in the Markdown itself as data URIs — one self-contained file, but a much larger one.

Is the document uploaded?

No. The .docx is unzipped and converted by code running in your browser. Nothing is sent to a server, which matters for contracts, HR documents and anything under NDA.

What about Google Docs?

Either download it as .docx (File → Download → Microsoft Word) and drop it here, or select the content in Google Docs, copy it, and paste it into the HTML to Markdown converter, which reads the formatting from the clipboard.

Limitations

Guides