Word to Markdown: Convert DOCX and Legacy Documents

Prepare your Word document for Markdown

Apply Word's built-in Heading 1 through Heading 6 styles before converting. A line that only looks like a heading because it is large or bold may remain a paragraph. Microsoft's heading-style instructions show how to apply the styles in Word.

A paragraph styled Heading 2 becomes a Markdown heading such as ## Installation. Bullets become list items and links keep their text and address. This example shows the mapping, not a promise that every Word layout transfers unchanged.

What carries over, and what needs review

• Built-in headings, quote and code styles, lists, bold and italic text
• Tables represented as Markdown rows, with the first row used as the header
• Word equations converted into LaTeX source
• Embedded images replaced by AI descriptions, with alt text retained when a description is unavailable
• Optional YAML frontmatter from available document properties

Custom Word styles can become ordinary paragraphs. Review nested lists and tables with merged cells. Check equations symbol by symbol and image descriptions against the original, especially when a diagram carries facts. A Markdown file does not preserve Word's fonts, pagination or exact page layout.

DOCX and older Word formats follow different paths

DOCX uses a browser conversion pipeline; embedded images are sent to the server to be described. DOC, RTF, ODT and Pages files are uploaded for a LibreOffice conversion to DOCX first. The Markdown result is released only after the document's credit charge succeeds.

Decide whether to keep the frontmatter toggle enabled. Metadata can be useful in an archive, but a destination may treat it as visible text. Check one converted document before migrating a collection. The Word conversion guide covers the workflow; the Word table guide focuses on row structure.