Free tool · Files Word to Markdown: convert DOCX to clean Markdown
Drop a Word document and get Markdown you can paste into a CMS, a docs site, a GitHub README or an AI chat. Headings, bold and italic, links, nested lists, tables, footnotes and images come across; fonts and colours are left behind. The file is read by your browser and never uploaded.
- Files stay on your device
- Headings, lists and tables kept
- Images in a ZIP
Convert Word to Markdown
Choose a .docx file. The result appears below; change the output or image settings at any time.
No file yet. Choose or drop a .docx file, or try the sample document.
ZIP: the Markdown links to images/ and both download together.
A full page adds <html>, <head> and <body>.
Preview
How Word elements are written
Each row was converted with the same code the tool runs. Word styles decide the structure: a paragraph in the Heading 1 style becomes #, whatever its font size.
| In Word | Markdown |
|---|---|
| Heading 1 style | # Annual report |
| Heading 2 style | ## Key results |
| Bold and italic | Plain, **bold** *and italic* |
| Hyperlink | [TapCub](https://tapcub.com/) |
| Bullet with a numbered sub-item | - Check headings 1. One H1 per page |
| Table | | Month | Visits | | --- | --- | | May | 12,400 | |
| Picture with alt text |  |
| Footnote | Survey result[^1] [^1]: Sample of 1,200 users, 2026. |
Text that only looks like a heading (big and bold, Normal style) stays a paragraph. Apply real heading styles in Word for a clean outline.
Version v1.0Updated Update history
What survives the conversion
Markdown describes structure, not appearance. Here is what comes across and what is dropped on purpose.
Structure
Headings come from Word’s heading styles (or outline levels), lists from Word’s bullets and numbering, including nesting. Tables become GitHub-style pipe tables; merged cells are split into empty cells, because Markdown tables cannot merge.
Inline formatting
Bold, italic, strikethrough, monospace text (as inline code) and external links are kept. Underline, colours, highlight and fonts have no Markdown equivalent and are dropped.
Images
Pictures are written as  and the files are packed into a ZIP with the Markdown. The alt text is taken from the picture’s description in Word, so fill that in.
Left out
Headers, footers, comments, page breaks and the table of contents. Text boxes are kept as normal paragraphs after the paragraph that holds them.
For a quick check of the Markdown, open the preview below the result, or paste it into the Markdown converter.
Convert a Word document in four steps
The defaults suit a blog post or a docs page.
-
1
Choose the .docx
Drop it on the box or click to pick it. Old .doc files need to be saved as .docx first.
-
2
Pick the output
Markdown for a CMS, static site generator, README or an AI tool; HTML for an editor that takes HTML.
-
3
Decide on images
ZIP gives you the Markdown plus an images folder; embed puts everything in one file; or leave images out.
-
4
Copy or download
Copy the text into your editor, or download the .md / .html (or the ZIP with images).
How the converter reads a .docx
A .docx file is a ZIP archive of XML files (the Office Open XML format, ECMA-376). The tool unpacks it with the browser’s built-in decompression and reads the parts it needs.
- word/document.xml holds the paragraphs, runs of text and tables, in reading order
- word/styles.xml says which paragraph styles are headings; word/numbering.xml says whether a list is bulleted or numbered and where it starts
- word/_rels/document.xml.rels maps link and picture IDs to web addresses and to files in word/media/
- Footnotes and endnotes come from footnotes.xml and endnotes.xml and are written as [^1] references
- Markdown output follows GitHub Flavored Markdown; characters that would accidentally format text (such as * or _) are escaped
| Part | What it holds | Used for |
|---|---|---|
| word/document.xml | Body text and tables | Everything you see |
| word/styles.xml | Style names and outline levels | Headings, quotes, code |
| word/numbering.xml | List formats and start values | Bullets and numbers |
| word/media/* | Pictures | images/ folder in the ZIP |
| word/footnotes.xml | Footnote text | [^1] notes at the end |
A Word section becomes Markdown
A short section with a Heading 2, a sentence with bold and a link, and a two-level list.
| In Word | Markdown |
|---|---|
| “Key results” in the Heading 2 style | ## Key results |
| “Visits rose 18%” with 18% in bold | Visits rose **18%** |
| “See the report” linked to a web page | [See the report](https://…) |
| Bullet “Channels”, numbered sub-item “Search” | - Channels / 1. Search (indented two spaces) |
| A 2 × 3 table | A header row, a --- row and one row per table row |
The numbered sub-item is indented under the bullet by the width of “- ”, which is what Markdown needs to nest it.
Where Word to Markdown goes wrong
Most problems start in the Word file, not in the conversion.
Fake headings
Big bold text in the Normal style is just a paragraph. Use Heading 1, 2 and 3 in Word and the outline comes out right.
Typed numbers
Lines that start with a typed “1.” are not a Word list. Use the numbering button so the converter can see the list and its levels.
Images without alt text
The alt text in Markdown comes from the picture’s description in Word. Fill it in (right-click › Edit Alt Text) for accessibility and SEO.
Layout tables
Tables used to position things on the page become real tables in Markdown. Replace them with plain paragraphs before converting.
The same privacy-first approach in our analytics
This converter keeps files on your device. TapCub applies the same idea to analytics: collect what you need, keep personal data out.
Cookieless visitor ID
Visitors are told apart by a keyed hash of the site, a salt, the IP address and the browser type. Nothing is written to the browser and the IP is never stored.
Learn moreCompliance centre
Choose balanced or strict, switch on IP truncation for some regions only, set the geography level and retention.
Learn moreSafeguards
Encryption in transit, sensitive fields encrypted at rest, masking by role, export and deletion of one person's data.
Learn moreWord to Markdown questions
Still have a question?
Chat with the team behind TapCub — we usually reply within a few hours on business days.
How do I convert a Word document to Markdown?
Drop the .docx file on the converter. The Markdown appears at once; copy it or download it as a .md file, or as a ZIP if the document has pictures.
Can I convert an old .doc file?
Not directly. .doc is a different, binary format. Open it in Word, WPS or LibreOffice, save it as .docx and convert that.
Are my documents uploaded?
No. The .docx is unpacked and converted by your browser. You can check in the developer tools’ Network tab, or switch off the internet after the page has loaded.
What happens to images?
By default they are saved in an images folder inside a ZIP and the Markdown links to them. You can also embed them in the file as base64 or leave them out.
Why did my heading become a normal paragraph?
Because it is formatted to look like a heading but uses the Normal style. Apply Heading 1–6 in Word, or set an outline level, and convert again.
Does it work with Google Docs?
Yes. In Google Docs use File › Download › Microsoft Word (.docx), then drop that file here.
Is the Markdown good for ChatGPT or other AI tools?
Yes. Markdown keeps headings, lists and tables as plain text, which AI tools read more reliably than pasted Word text. Leave images out for that use.
Update history
New features, fixes and data refreshes for this tool, newest first.
-
· v1.0
LaunchedFirst release.
Missing something or found an error? Tell us — requests that come up often go into the next update. All tool updates
Analytics that keep personal data out
TapCub counts visits without cookies and never stores IP addresses, with a compliance centre for stricter regions.