DOCX to Markdown Converter

Convert DOCX to Markdown privately in your browser. Keep Word headings, tables, nested lists, links, equations, and embedded images, then copy Markdown or download an assets ZIP.

For reliable embedded image extraction, open the .docx rather than pasting — Word clipboard images are not always exposed to browsers.

The docx to markdown converter with a document list on the left, generated Markdown in the middle, and conversion settings on the right.
Document tabs, converted Markdown, and the conversion settings panel.

What DOCX to Markdown Conversion Actually Does

A docx to markdown conversion is a structural translation, not a copy-and-paste. Underneath its extension, a .docx file is a ZIP archive holding XML: the text, a separate style table, a relationship map, and a media folder. This converter opens all of it in your browser and rebuilds the document as plain text.

  • Styles decide the output: A paragraph styled Heading 2 becomes ##. A paragraph that is merely large and bold stays a paragraph — which is usually what you want to discover.
  • Media is unpacked, not linked: Pictures live as real files inside the archive, so the converter can write them to assets/ and rewrite each image reference to match.
  • Batch friendly: Open up to twelve documents, keep them as tabs, and apply one rule set across the whole batch instead of repeating yourself.
  • The file stays with you: Everything runs after the page loads. No upload, no conversion queue, no copy of your document on someone else's disk.

A DOCX to Markdown Converter Built for Real Files

Word documents in the wild have merged table cells, numbered headings, pasted screenshots and equations. These are the parts a naive docx to markdown converter loses first.

DOCX to Markdown Reads the OOXML

DOCX to Markdown unpacks document.xml, the style table, and the relationship map, so a real Heading 2 becomes ## instead of a guess based on font size.

Heading 1–6 Mapped to # Through ######

Word outline levels land on the matching Markdown hierarchy, so the converted file keeps a valid document tree that Docusaurus sidebars, Hugo tables of contents, and Obsidian outlines can read.

Embedded Media Extracted

Images stored in word/media are written out as assets/image-001.png with matching ![alt](path) references, embedded as data URLs for one portable file, or dropped for a text-only result.

Tables and Multi-Level Lists

Ordinary Word tables become GFM pipe tables. Nested numbered and bulleted lists keep their depth. Merged cells stay as sanitized HTML, because pipe syntax has no rowspan to convert them into.

OMML Equations to LaTeX

Word's native equation format is converted to $…$ and $$…$$ LaTeX, so formulas survive as editable text rather than turning into blank space or a flattened picture.

DOCX to Markdown for RAG and LLMs

Strips document chrome and style noise down to headings, lists, and tables. The result chunks predictably and costs far fewer tokens than raw Office XML pushed through an extraction service.

Twelve Documents in One Pass

Drop a folder's worth of files, switch between them in the list on the left, and apply one rule set to a single document or to the whole batch at once.

Source Beside Rendered Preview

Split view scrolls the generated Markdown next to its rendered form so you can spot a broken table or a lost heading before the file reaches your repository.

Nothing Is Uploaded

Unzipping, XML parsing, image extraction, and ZIP packaging happen on your device. For contracts, HR files, and anything under NDA, the document never reaches a conversion queue.

What Each Word Element Becomes

The exact docx to markdown mapping, so you know what to check after converting rather than reading the whole file twice.

In the .docxIn the MarkdownNotes
Heading 1 – Heading 6# … ######Outline level, not font size
Bold / Italic / Strikethrough**b** _i_ ~~s~~Character runs merged
Hyperlink[label](url)Relationship target resolved
Bulleted & numbered lists- item / 1. itemNesting depth preserved
Table| a | b |Merged cells kept as HTML
Inline code / Code style`code` and fencesLanguage kept when tagged
Embedded picture![alt](assets/…)Extracted from word/media
Equation (OMML)$E = mc^2$Converted to LaTeX
Blockquote style> quoteIndent level flattened

Convert DOCX to Markdown in 3 Steps

From a Word file to committed Markdown with its images, without installing a desktop converter or signing up for anything.

1

Open a .docx file

Drag one or more Word files onto the converter, or use Open. Modern .docx is required — the legacy binary .doc format has to be re-saved in Word or LibreOffice first.

2

Pick image handling and cleanup

Choose an assets folder, inline data URLs, or no images at all, then set link handling, clean mode, and merged-table behaviour. Apply the settings to the current file or to every open document.

3

Copy, download, or export a ZIP

Review the output in split view, then copy it, save a single .md, print it, or download Markdown and its extracted images together as one ZIP ready to commit.

The Same Conversion, From Another Angle

This page stays at the format level. Two neighbours pick up where it stops.

Got a .doc, or not sure what you have?

The same converter written without the OOXML detail: legacy .doc files, Google Docs and Pages exports, pasting from Word, and what to do when a table comes out wrong.

Need the trip back?

Build a real Office Open XML file from Markdown — Heading 1–6 styles, native tables, a working table-of-contents field, and LaTeX as editable equations.

DOCX to Markdown Questions

Straight answers on images, equations, tables, legacy .doc files, Pandoc, conversion limits, and document privacy.

How do I convert DOCX to Markdown online?
Drop a .docx file onto this page or choose Open. The browser unpacks the file, reads its XML, and produces Markdown in an editable pane beside a rendered preview. From there you can copy the result, download a .md file, print it, or export Markdown plus extracted images as a ZIP.
Does DOCX to Markdown keep images?
Yes. Pictures stored inside the file's word/media folder are extracted and re-linked. The default mode writes them to an assets/ folder and downloads everything as one ZIP; data-URL mode inlines them into a single self-contained .md instead.
Can it convert a .doc file?
No. Legacy .doc is a binary format from the pre-2007 Office era, not a ZIP of XML, so there is nothing for a browser converter to unpack. Open it in Word or LibreOffice, save as .docx, then convert that file here.
What happens to Word equations?
OMML equations are translated into LaTeX delimited with $ or $$, which renders in GitHub, Obsidian, MkDocs Material, and most static site generators. Very long aligned environments and matrices are worth checking by eye after conversion.
How does this compare with Pandoc for docx to markdown?
Pandoc is the better choice for scripted, repeatable pipelines: pandoc input.docx -o output.md --extract-media=assets gives you version pinning, per-file logs, and CI integration. This page is the better choice when you want a result in a few seconds without installing anything, or when the document is confidential and you would rather it never leave the browser.
How are tables handled in DOCX to Markdown?
Simple rectangular tables become GFM pipe tables with a header row. Tables with merged, nested, rowspan, or colspan cells are kept as sanitized HTML by default, because flattening them into pipe syntax silently loses the structure. Turn that option off if your renderer rejects inline HTML.
What does not survive DOCX to Markdown conversion?
Tracked changes, comments, headers and footers, page numbers, fields, text boxes, SmartArt, and precise page layout have no Markdown representation. Footnotes and captions become plain paragraphs. Resolve or export anything meaningful in Word before converting, and keep the .docx as the source of record.
Is DOCX to Markdown private?
Yes. Every step — unzipping the container, parsing the XML, extracting media, rendering the preview, building the ZIP — runs locally in your browser. The file is not uploaded, queued, logged, or stored by this site.

Convert DOCX to Markdown Now

Scroll back to the converter, drop a Word file, choose how images are handled, and download clean Markdown with its assets.