How to convert Word to markdown
To convert word to markdown, the tool opens your .docx file in the browser, reads the document text and its styles, and writes markdown for the parts that markdown can express. A .docx file is a zip archive with the text in an XML file, and this converter reads that XML directly. Nothing is uploaded.
A document made from the built-in example, a project update with three headings, lists, a table, a code block and two links, comes out like this:
# Project update
This week the **beta launch** went well. Read the [full report](https://example.com/report) for numbers, or see the notes below.
## What shipped
- Faster search
- New export options
- Word and PDF
- CSV with custom delimiters
- [x] Bug fixes for `login` and `logout`What is kept when you convert a Word document to markdown
- Headings. Paragraphs in the Heading 1 to Heading 6 styles, and the Title style, become lines that start with one to six
#signs. A paragraph with an outline level set is treated as a heading too. - Bold, italic and strikethrough, including bold and italic that comes from the Strong and Emphasis character styles.
- Links. Word hyperlinks, link fields and plain web links keep their address.
- Lists. Bulleted and numbered lists keep their nesting and the number a list starts at. Lines that begin with a ☐ or ☑ box become task items.
- Tables. The first row becomes the header and column alignment is kept. Line breaks inside a cell are written as
<br>, and a|inside text is escaped. - Code. A run of paragraphs in a monospace font, such as Consolas or Courier New, or in a style named Code or Source Code, becomes a fenced code block. A monospace phrase inside a sentence becomes inline code.
- Block quotes from the Quote style.
Convert docx to markdown: what gets simplified
Markdown is plain text with a few marks, so a Word document always holds more than the result can. The note above the output counts each kind of loss, so you know where to look:
- Pictures are not extracted. Each one leaves a placeholder like
, using the picture's alt text, so you can add the files yourself. Turn Image placeholders off to leave them out. - Footnotes, endnotes and comments are not converted.
- Tracked changes: inserted text is kept as normal text and deleted text is removed.
- Text boxes and shapes lose their text. Equations become plain text.
- Merged table cells are split into separate cells, and a table nested inside a table is flattened to text.
- Underline, font names, sizes, colors, highlights, alignment and page layout are not part of markdown and are dropped.
- Headers and footers are ignored.
Word to markdown for Google Docs, Notion and GitHub
Most editors can export or import .docx, which makes it the common way to move writing into markdown. In Google Docs, choose File, Download, Microsoft Word (.docx) and drop the file here. The markdown then works in a GitHub README, a static site, a wiki or a note app.
If you only want the words with no symbols, run the markdown through Markdown to Text. If the document holds a data table, CSV to Markdown and HTML Table to Markdown cover other sources for the same kind of table.
Back to Word
To turn markdown back into a document, use Markdown to Word. The Swap button between the panels sends your markdown straight there. Headings, lists, tables, links and code survive the round trip, while fonts and colors from the original file do not come back.
File types and limits
- Only .docx is supported. For an old .doc file, open it in Word or LibreOffice and use Save As .docx first.
- Pages, Google Docs links, ODT and PDF files are different formats and are not read.
- Password protected files cannot be opened.
- Files up to 15 MB are accepted. A very long document can take a moment.
The file is opened and converted in your browser. It is not uploaded or stored. See the Privacy Policy for details.