How to use it
- Choose or drop a .docx file.
- Decide whether images should be embedded.
- Check the Markdown in the text box.
- Copy it or download it as an .md file.
How it works
The document is first turned into semantic HTML with the mammoth library (headings come from Word's heading styles, Title and Subtitle become levels 1 and 2), and that HTML is then written as GitHub-flavoured Markdown: # headings, **bold**, *italic*, ~~strikethrough~~, `inline code`, fenced code blocks for code styles, links, nested bulleted and numbered lists, > quotes, horizontal rules and pipe tables.
Markdown tables always have a header row, so the first row of each Word table is used as the header. Merged cells, cell colours and line breaks inside cells are not representable and are flattened. Characters that Markdown would treat as formatting (such as * or _ in normal text) are escaped with a backslash.
Fonts, colours, alignment, page layout, headers, footers and comments are not converted. Old binary .doc files are not supported.
Examples
Documentation for a repository
A setup guide written in Word becomes a README.md with ## headings, numbered steps and code blocks for the commands formatted with a code style.
Moving notes to a Markdown app
Meeting notes with bullet lists and links convert into Markdown you can paste into Obsidian, Notion or a static-site generator.
Frequently asked questions
Why are my headings normal text?
Only paragraphs with Word's heading styles (or Title/Subtitle) become Markdown headings. Text that was just enlarged by hand stays a paragraph.
Why does my table look different?
Markdown tables are simple grids with one header row. Merged cells, multiple paragraphs in a cell and nested tables cannot be represented and are flattened into single lines.
Why are there backslashes in my text?
Characters such as *, _, [ and # would otherwise start formatting in Markdown. The backslash keeps them as plain characters and is not shown when the Markdown is rendered.
Privacy
The Word file is converted in your browser. The document and the Markdown are not uploaded, stored or included in analytics; only an anonymous event that the tool was used is counted.