Convert DOCX to Markdown

DOCX is usually the cleanest Word input for Markdown

DOCX files contain more structured document information than older .doc files, which makes them a better source for Markdown conversion. The goal is to preserve the authoring structure: headings become Markdown headings, lists become Markdown lists, and simple tables become Markdown tables.

Use this page when the source file ends in .docx, including exports from Microsoft Word, Google Docs, and LibreOffice. Older .doc files use a separate conversion path and belong in the legacy DOC converter.

DOCX to Markdown workflow

1. Upload your .docx file from Word, Google Docs export, LibreOffice, or another editor that saves DOCX.
2. DocToMD extracts the document structure and builds a Markdown preview from headings, paragraphs, lists, links, emphasis, and tables.
3. Check tables, image alt text, footnotes, and anything that depended on page layout, then copy the Markdown or download it as a .md file.

What DOCX structure maps well to Markdown

• Headings
• Bold, italic, and strikethrough
• Numbered, bulleted, and nested lists
• Tables
• Links and bookmarks
• Footnotes and endnotes

DOCX to Markdown example

# Fixture Document

## Lists

1. First numbered

- Bullet one

## Table

|  |  |  |
| --- | --- | --- |
| Wide head |  | End |
| Tall | B2 | C2 |
|  | B3 | C3 |

DOCX formatting support

DOCX to Markdown examples

# Fixture Document

Plain paragraph with **bold**, *italic*, and ~~struck~~ runs.

**Style-bold paragraph with a NotBold-styled span inside.**

## Lists

1. First numbered

2. Second numbered

   - a) Alpha sub one

   - b) Alpha sub two

        - i. Roman sub sub

3. Third numbered

Interrupting paragraph between lists.

4. Fourth, continuing the count

- IV. Roman starting at four

- I. Roman five

- Bullet one

- Bullet two

  - Nested bullet

## Table

|  |  |  |
| --- | --- | --- |
| Wide head |  | End |
| Tall | B2 | C2 |
|  | B3 | C3 |

## Links and anchors

External link to [example](https://example.com/page).

Relative link to [a sibling file](../../fixture-src/sibling.odt).

<a id="plainmark"></a>This plain paragraph carries a bookmark.

Jump to [the bookmarked paragraph](#plainmark).

DOCX conversion notes

• Merged table cells in the verified fixture become empty cells
• The verified fixture writes image alt text into the paragraph and does not embed the image
• Text box content can appear as paragraphs; the box layout is not kept
• Comments and tracked changes are not claimed; the verified fixture contains neither

Best uses for DOCX to Markdown

Use this page for modern Word documents, Google Docs exports saved as DOCX, documentation drafts, and content that needs to move into GitHub, a static site, or a docs platform.

If the document depends on page layout, columns, or floating images, expect to review the Markdown before publishing. For a file that might be .doc or .docx, start at Word to Markdown. Several HTML, PDF, or text files packed together belong on ZIP to Markdown.

When DOCX is the best Word input

Choose DOCX when you can control the export format or when headings, lists, links, and simple tables matter. The resulting Markdown is suitable for editing in GitHub, documentation systems, static sites, and knowledge bases.

Export from LibreOffice or OpenOffice

LibreOffice Writer and Apache OpenOffice Writer save text as OpenDocument. In LibreOffice, choose File → Save As, then ODF Text Document (.odt) or a Word document (.docx). In Apache OpenOffice Writer, choose File → Save As, then ODF Text Document (.odt).

Upload the saved .odt, or a .docx file from LibreOffice, with ODT to Markdown.

LibreOffice Writer 26.2 and later can also save Markdown Document (.md) with File → Save As. That export follows CommonMark. Current 26.2 builds still escape some code and punctuation incorrectly, and page layout stays in the original document. Older LibreOffice releases use the .odt or .docx save, and this converter reads those files.