MODE

Word to Markdown Converter

Drop a .docx file and get Markdown ready for GitHub or your docs site.

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.

Word to Markdown Converter examples

  • Convert Word document tables and copy into Markdown

    Input

    [Word .docx document content]

    Result

    # Overview
    
    Convert text easily using browser-based tools.
    
    | Tool | Category |
    | --- | --- |
    | Case Converter | Text |

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

Does it support the older .doc format?
No, only .docx. Open a .doc file in Word and use Save As to create a .docx first.
Why are my headings plain text?
The document probably uses manual formatting instead of Word's Heading styles. Apply real heading styles in Word and convert again.
Is my file uploaded?
No. It is processed in your browser.

Guides that use this tool

Related tools

[ Browse all tools ]