iformat.io Logo iformat.io
iformat.io Logo iformat.io

Word (DOCX) to Markdown Converter

Convert Microsoft Word files (.docx) to clean Markdown while preserving the heading levels, bullet lists, and tables you set up in Word. Unlike copy-pasting into a plain-text editor, this keeps semantic structure — H1/H2/H3, bold, italic, numbered lists, and pipe tables all survive the trip. Ideal for anyone moving from a Word-based writing workflow into GitHub, Notion, Obsidian, or a docs-as-code pipeline.

Drop your DOCX file here
Max 20 MB · 5 conversions per hour

What this converter preserves

  • Preserves the exact Word heading levels — a Heading 2 in your .docx becomes ## in Markdown, not # or bold text
  • Converts numbered and bulleted lists correctly, including multi-level nesting up to 6 levels deep
  • Extracts inline formatting (bold, italic, strikethrough, inline code) with proper Markdown syntax
  • Handles Word tables cleanly as GitHub-flavored pipe tables — no HTML fallback

When you'd use this

  • Migrating a legacy Word-based documentation site to Markdown for hosting on GitHub Pages, Netlify, or Vercel
  • Feeding Word-authored spec documents into RAG systems for internal LLM search
  • Cross-team collaboration: writers author in Word, engineers commit the Markdown output to the docs repo
  • Converting blog drafts written in Word to Markdown for Ghost, Hugo, or a self-hosted WordPress with the Markdown plugin

How it works

  1. 1
    Upload your .docx file
    Drag and drop a Word document, or use the file picker. Only .docx (Office 2007+) is supported.
  2. 2
    Convert
    Click Convert to send the file to our server. Conversion typically completes in under a second for a 10-page document.
  3. 3
    Copy or download
    The Markdown appears in a preview pane. Use the copy button to grab it, or download as a .md file.

Frequently asked questions

Will comments and tracked changes be included?

No — comments and tracked-change markup are stripped. Accept or reject changes in Word first if you want them reflected in the output.

What about images and embedded objects?

Text content converts fully. Embedded images render as `[Image]` placeholders in the Markdown output. If you need images extracted, unzip the .docx (it's a ZIP archive) and pull them from the `word/media/` folder.

Does this work with .doc (old format) too?

No — MarkItDown only supports the modern .docx format (Office 2007+). Open a .doc file in Word first and Save As → .docx.

Are Word footnotes and endnotes handled?

Footnotes are included as Markdown footnote references at the end of the document. Endnotes work the same way.

What if my Word doc uses custom fonts or styles?

Markdown is font-agnostic — custom fonts are dropped. Style-based formatting (Heading 1, Emphasis, etc.) is mapped to Markdown; ad-hoc formatting like manually-changed font sizes is not.
Reviewed by Editorial team Updated