Word to Markdown: convert a .docx without uploading it

Word already knows what a heading is. A PDF stores glyphs at coordinates and leaves structure to be guessed at, but a .docx names its own headings, list levels and table cells — so converting one to Markdown is a translation rather than an inference, and the result needs less cleaning up.

5.0 out of 5 from 23 ratings

Drop your PDF or Word file here

or choose a file from your computer

PDF or Word (.docx) · up to 50 MB

Is converting Word to Markdown more accurate than converting a PDF?

Yes. A .docx records its own structure: a style name says which text is a Heading 2, the numbering says which list is ordered, and the markup says where each table cell begins. A PDF stores none of that and has to infer it from font size and spacing.

What does a Word to Markdown conversion leave out?

Images, equations, comments and footnotes are not carried into the Markdown, and tracked deletions are dropped while tracked insertions are kept. Markdown has no merged table cells either, so a merged cell becomes one filled cell and one empty one.

Why did my Word headings not become Markdown headings?

Because the converter reads the paragraph style, not the appearance. Text enlarged and bolded by hand is still Normal style, so it converts as an ordinary paragraph. Apply Heading 1 to 6 in Word and it converts every time.

How to convert a Word document to Markdown

  1. 1

    Open the converter

    Go to mypdf2md.com. There is nothing to install and no account to create.

  2. 2

    Add your .docx

    Drag the Word file onto the drop zone, or click to pick it from your computer. Files up to 50 MB are accepted.

  3. 3

    Check the structure

    Headings, lists and tables appear in the Markdown pane with a live preview beside it. Edit anything that needs a nudge before you take it away.

  4. 4

    Copy or download

    Copy the Markdown to your clipboard, or download it as a .md file named after the original document.

What Word states outright

A .docx is a ZIP holding several XML parts. The converter opens four of them: the document itself, the styles, the numbering definitions and the link relationships. Everything Markdown can represent is in those four.

That is why the output usually needs less correcting than a PDF conversion does. Nothing here is guessed at from the shape of the page.

  • Headings, from the paragraph style, including Title and Subtitle
  • Bulleted and numbered lists, at the nesting depth the document declares
  • Tables, with horizontally merged cells padded so later columns stay under the right heading
  • Bold, italic, strikethrough and monospaced text
  • Hyperlinks, resolved to the address they actually point at
  • Quotes and code blocks, from the styles Word applies to them

What does not survive the conversion

Markdown carries no image bytes and this converter uploads nothing, so figures are counted and the number left out is reported rather than quietly dropped. Equations, comments and footnotes do not come across either.

Tracked changes are resolved to the document as it now reads: insertions are kept, deletions are discarded. Fields such as an automatic table of contents are instructions to Word rather than content, so they are skipped — a converted document should not contain PAGEREF codes.

Where the file is read

The .docx is unzipped and parsed in your browser tab. You can check it: open the network panel while a conversion runs and there is no upload to see.

The embedded images are never even read, because only the four XML parts the converter needs are decompressed. A 40 MB document full of photographs inflates a few hundred kilobytes of markup and leaves the photographs where they are.

Word habits that convert badly

Almost every disappointing .docx conversion has one cause: the document looks structured on screen without being structured underneath. The converter reads what Word recorded, and Word records the style you applied rather than the effect you achieved.

None of this is a fault in the file. It is the difference between formatting a document and structuring one, and it stays invisible until something other than Word reads it.

  • A line made large and bold by hand is Normal style, and converts as a paragraph
  • A list typed as literal 1. or - characters is text; Word's own numbering is what converts
  • A table used to lay out a page converts as a table, because that is what it is
  • Nesting made with tabs or spaces carries no list level, so nested items flatten
  • A run set in Consolas or Courier converts as code, since a monospace face is the only code signal Word carries

What survives that you might not expect

Text inside a floating text box is not lost. Word stores it within the drawing that holds the box, and the converter goes in after it rather than writing the whole drawing off as a picture it cannot carry.

Content controls, the dropdowns and date pickers a template leaves in a form, are unwrapped to the text they currently hold. Tracked insertions are kept and tracked deletions dropped, so what you get is the document as it now reads. A vertically merged table cell is carried down its column instead of leaving a hole in the grid.

Frequently asked questions

Can it open older .doc files?
No. A Word 97-2003 .doc is a different format inside, not a renamed .docx. Open it in Word, save it as .docx, and convert that. The converter recognises the case and says so rather than reporting a generic failure.
Why is there no page count for a Word document?
A .docx stores no pagination. Word recalculates it at display time from the fonts, the page size and the printer driver, so the same file is 12 pages on one machine and 14 on another. The free limit is therefore counted in words.
What happens to a table of contents?
It is left out. A Word table of contents is a field that regenerates itself, and its underlying markup is machine syntax. The headings themselves are converted, and any Markdown tool can build its own contents list from those.
Can it convert a password-protected Word file?
No. An encrypted .docx is a different kind of container inside, and the converter reports it as such. Remove the password in Word, save a copy, and convert that. Password-protected PDFs are supported.
Why did part of my document convert as code?
Word has no flag marking a run as code, so a monospace typeface is the only signal the file carries. Anything set in Consolas, Courier New or a similar face converts as inline code. Change the font in Word if that was not the intent.

Related converters

Further reading