How the Word to Markdown Converter works

The document is read by Mammoth, which maps Word styles to semantic HTML (Heading 1 becomes h1, list styles become lists, bold and italic stay as emphasis), and the HTML is then converted to Markdown. Because it keys off style names, documents that use real heading styles convert much better than those that just make text big and bold.

Embedded pictures are not copied; a placeholder marks where each image was. The tool shows any warnings from the converter, such as an unrecognized style, so you know what to check by hand.

When it is useful

• •Moving documentation from Word to a Git repository.
• •Publishing a draft to a static site or a Markdown based CMS.
• •Cleaning a document for use in a note taking app.
• •Extracting structured text from a report.

Frequently Asked Questions