Skip to content

Convert

DOCX to Markdown

DOCX to Markdown

Beta

Drop a Word .docx and get clean Markdown for a README, a wiki page or a site. Headings, lists, links, tables and emphasis are kept; fonts and layout are not. Nothing is uploaded.

  • Free, no sign-up
  • Updated
  • Reviewed by Olgun Ozoktas
Drop your Word document hereor click to browse for a .docx file
Works in your browser
No uploads to servers
Markdown Output
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Your document stays on your device

The .docx is unpacked and converted in your browser. The file is never sent to FindUtils or anywhere else — you can confirm it in your browser's network panel while converting.

Why Use Our DOCX to Markdown Converter?

Briefs, specs and policies get written in Word because that is where the people writing them live. READMEs, wikis, docs sites and static pages get written in Markdown because that is where the text ends up. The trip between them is done far too often by copying out of Word and cleaning up by hand, or by installing Pandoc for a one-off. This page reads the .docx in the tab and writes Markdown that keeps the structure a reader cares about — headings, paragraphs, lists, links, tables, bold and italic — and drops the styling a Markdown file cannot hold anyway. Copy it into the README, or download the .md.

A .docx file is a zip archive of XML, and the part that matters for Markdown is the document body: a sequence of paragraphs, each with a style, each holding runs of text with formatting, plus tables and hyperlinks. This converter reads that body in the browser and writes semantic HTML from it — Heading styles become heading elements, list paragraphs become lists, hyperlinks become links — and then writes Markdown from the HTML using the same converter the Site to Markdown page uses, which is what gives tables a pipe-table form rather than a flattened paragraph.

What survives is what Markdown can express: headings, paragraphs, bold, italic, links, bulleted and numbered lists, tables, and images if you ask for them. What does not survive is what Markdown cannot: fonts, colours, sizes, columns, page breaks, headers and footers, tracked changes and comments. That is a feature of the destination, not a limitation of the converter, and the page says so rather than promising a print-faithful copy.

The file is checked before anything heavy runs. A Word document in the current format starts as a zip; a legacy .doc and a password-protected .docx both start as an OLE compound file, and both get the same clear message, because the fix for both is the same: save as an unprotected .docx. Everything runs in the browser. The document is never uploaded.

How it compares

Pandoc does this conversion well and does fifty others, at the cost of an install and a command line. Online converters upload the document, which for a contract, a policy draft or an unreleased spec is the thing that must not happen. This page keeps the job to one drop and keeps the file in the tab, and it is the reverse of the Markdown to Word page, so a document can make the round trip without leaving FindUtils.

DOCX to Markdown Tips

  • Use Word's built-in Heading styles. A line that merely looks like a heading — bold, larger font — is still a paragraph to the converter, because the document says it is one.
  • Word lists become Markdown lists only when they are real lists. Lines that start with a typed hyphen or a typed number stay plain text, which is usually what you want.
  • Table cells that contain line breaks or nested lists flatten to one line each; pipe tables have no way to hold more. Check any table with long cells.
  • A legacy .doc is a different, binary format. Open it in Word or LibreOffice and save as .docx; the conversion takes a second and this page then reads it.
  • The conversion notes list Word features that had no Markdown equivalent, such as a custom paragraph style. The text of those parts is kept; only the styling is lost.

Frequently Asked Questions

What parts of the Word document are kept, and what is lost?

Kept: headings that use Word's Heading styles, paragraphs, bold and italic, hyperlinks, bulleted and numbered lists, tables, and images if you turn the option on. Lost: fonts, colours, font sizes, text alignment, columns, page breaks, headers, footers, footnotes, comments and tracked changes. Markdown has no way to hold those, so they are dropped rather than approximated.

Can it read an old .doc file?

No. A .doc is a binary format from before 2007 and is not a zip of XML. Open it in Word, LibreOffice or Google Docs and save it as .docx, then drop that. The page recognises a .doc by its first bytes and tells you this instead of failing silently.

The file is password-protected. Why is it refused?

A password-protected .docx is encrypted and wrapped in the same container format as a legacy .doc, so it cannot be unpacked without the password, and this page does not ask for one. Remove the protection in Word (File, Info, Protect Document) and save, then drop the unprotected file.

What happens to images?

By default they are left out and the count is shown, because a single embedded photo can be larger than the rest of the Markdown and most projects keep images in a folder anyway. Turn on Include images and each one is embedded as a data URL inside the Markdown, which is self-contained but large. Either way, the text around the image is unaffected.

Do tables convert?

Yes, to pipe tables with a header row. Merged cells, cells with several paragraphs and nested tables flatten, because a Markdown table cannot hold them. Check any table with long or complex cells; the text is there, the layout may not be.

Is my document uploaded?

No. The .docx is unpacked and converted in your browser. Nothing about the document is sent to FindUtils or to any other server, and you can confirm that in the network panel while converting. A brief or a contract is exactly the kind of file that should be converted this way.

What are the conversion notes?

A list of Word features the converter met and had no Markdown for — most often a custom paragraph style, a text box or an unusual list format. The text of those parts is still in the output as plain paragraphs. The notes tell you where to look if something reads as flatter than the original.

Can I convert a Google Docs document?

Yes. In Google Docs choose File, Download, Microsoft Word (.docx), then drop the downloaded file here. Google's export uses Heading styles and real lists, so the Markdown comes out clean.

Can I go the other way, from Markdown to Word?

Yes. The Markdown to Word converter on FindUtils builds a .docx from Markdown, with headings, lists, tables, code blocks and an optional header banner. Together the two pages make the round trip without leaving the site.

Why did a bold line not become a heading?

Because the document says it is a paragraph. The converter reads Word's styles, not its appearance: a line styled Heading 2 becomes ##, a line that is merely bold and 18 pt stays a bold paragraph. Apply the Heading styles in Word, or add the # characters in the editor on the right before you download.

I need HTML instead of Markdown. Is there a page for that?

Yes. The DOCX to HTML converter on FindUtils reads the same .docx and writes clean semantic HTML — headings, lists, links, tables and emphasis with no classes or inline styles — for a CMS, a blog or an email editor, with a preview and an optional full-document wrapper.

My file is a LibreOffice .odt, not a .docx. What now?

Use the ODT to Markdown converter, the LibreOffice twin of this page. It unpacks the .odt in the browser and writes Markdown with the same converter; the one difference is that it keeps text only and counts images instead of offering to embed them.

Rate This Tool

0/1000

Get Weekly Tools

Suggest a Tool