Convert a Word Document to Markdown
Drop a .docx in and get Markdown out: headings, bold and italic, links, bulleted lists, tables and code in a monospaced font all come across. Copy the result or download it as a .md. The file is unzipped and read in your browser, so it stays on your device.
Drop a Word file here or browse
.docx only · stays on your device · no account
Why convert a Word file to Markdown
Markdown is what README files, wikis, static-site generators, GitHub issues and most notes apps expect, and the document someone sent you is a .docx. Pasting from Word into one of those gives you either flattened text with every heading lost, or a pile of HTML with Word's styling baked in. A conversion keeps the structure and drops the styling, which is the point of Markdown.
A Word file is a zip archive with XML inside, so a browser can open it without any help: the document XML is unzipped and read here, in the tab, and the Markdown is written from what it says. Nothing is uploaded, which matters for the kind of document that usually needs this: a contract, a policy, a CV, work you are being paid for.
What comes across
Headings and their levels, paragraphs, bold and italic, strikethrough, hyperlinks with their address, bulleted lists with their nesting, tables, text in a monospaced font (which becomes inline code), and manual page breaks (which become a horizontal rule). Characters that mean something in Markdown, such as a literal asterisk or an underscore in the text, are escaped so they stay literal.
Two choices are yours. Headings can use hash marks, which every Markdown flavour reads, or the underlined style for the first two levels. Tables can be pipe tables, which GitHub, GitLab and most wikis render, or HTML tables for a processor that only knows the original Markdown.
What does not, and why
Pictures are left out, and the tool says so when the document has any. Markdown can only reference an image by a path, and there is no path to give: the pictures live inside the zip. Numbered lists come out as bullets, because Word stores the numbering scheme in a separate part that is awkward to resolve, and a wrong sequence is worse than a dot; renumbering by hand takes seconds. Footnotes, headers and footers, text boxes, comments and anything that depends on page layout are not carried across. Tracked changes are resolved the way Word shows them: insertions kept, deletions dropped.
Alignment, colours, fonts and spacing are not converted because Markdown has nowhere to put them. If the document's appearance is what you need to keep, converting it to PDF is the better tool.
Frequently asked questions
Is my document uploaded to convert it?
No. The .docx is unzipped and read inside your browser and the Markdown is produced there too; the file never leaves your device. You can confirm it by watching the Network tab in the developer tools while you convert.
Do hyperlinks survive the conversion?
Yes. A link to a web address comes through as a Markdown link with its text and its URL. A link to a bookmark inside the same document comes through as plain text, because there is nothing outside the file for it to point to.
Why did my numbered list become bullets?
Word keeps the numbering style in a separate part of the file, with overrides and restarts that are hard to resolve reliably. Rather than guess a sequence and get it wrong, the tool writes bullets and tells you so; changing them to 1. 2. 3. in the output takes a moment.
Which Markdown flavour is the output?
CommonMark with the GitHub extensions most tools understand: pipe tables and strikethrough. Choose HTML tables and hash-mark headings if your processor is strict, and the output is plain CommonMark with embedded HTML for the tables.
Can I convert a .doc or a Google Docs file?
Not directly. An old .doc is a different, binary format; open it in Word or LibreOffice and save it as .docx first. From Google Docs, use File, Download, Microsoft Word to get a .docx, then drop that here.
Last updated October 21, 2026