Document tools

Word (DOCX) to Markdown

Convert docx to markdown with pandoc. Runs entirely on your device.

Runs on your device. The file is never uploaded.

Word (DOCX) to Markdown turns a Word document into pandoc extended Markdown, keeping heading levels, bold, italic, lists and tables. The .docx travels in on pandoc input-files path, since its bytes cannot be decoded to a string. Embedded pictures land in a media bag this tool never returns, so image links name files you never get.

Input

Questions

Where did the images from my Word document go?

Nowhere you can reach. Pandoc extracts embedded pictures into its own in-memory media bag, and this tool returns only pandoc's text output, so you get Markdown image links pointing at media paths whose files you never receive. A .docx is a zip archive, so rename a copy to .zip and take the pictures out of its word/media folder if you need them.

Does it keep my headings, bold text and tables?

Yes. Word heading styles become Markdown headings at the matching level, bold and italic survive, lists stay lists and tables come across as tables. Word features Markdown cannot express are lost: text boxes, SmartArt, drawing canvases, page headers and footers, columns, and anything that is page layout rather than document structure.

Why does my .doc file fail?

Because pandoc reads .docx, the Office Open XML format, not the old binary .doc. The tool shows the first line of pandoc's own error, or "pandoc produced no output converting docx to markdown" when pandoc said nothing at all. Open the file in Word or LibreOffice and save it as .docx first.

Which Markdown dialect is the output?

Pandoc's extended Markdown. Tables, footnotes and definition lists all have a syntax there, which is why a Word document survives the trip better than it would into strict CommonMark. Check anything unusual before pasting into a system that expects GitHub Markdown.

Are tracked changes and comments included?

Whatever pandoc's own defaults do with them, since this tool passes pandoc no options. Do not rely on it either way: accept or reject your tracked changes and resolve your comments in Word before converting, so what you see in Word is what the Markdown will contain.

How do I get from Markdown back into Word?

Use Markdown to Word (DOCX). If a web page is what you need instead, Word (DOCX) to HTML converts the same file in one step. Everything runs in a Web Worker in this tab; the document is never uploaded. A Markdown file that came from Word will not return to Word looking the way it started, because the styling was dropped on the way out and pandoc applies its own default document coming back.

Related Document tools