What carries over from .md to .docx?

Structure maps across: headings, paragraphs, lists, links, tables, code blocks, and inline emphasis. Anything that depends on the source presentation layer can be simplified or dropped, including page layout, fonts and colors, comments and tracked changes, and deeply nested or merged tables. Review those areas before you publish the result.

What are the file limits?

Accepted file types are .md, .markdown. Each file must be 10 MB or smaller.

Is my content private?

Processed on mdedit.ai servers. Uploaded files are stored in a private S3 bucket (not publicly readable). Uploads use signed URLs, and results are provided via time-limited signed download links. Files are automatically deleted after 30 days.

Markdown to Word

Convert Markdown to Word (DOCX) so you can edit it in Word or Google Docs.

Convert from

Convert to

This tool requires JavaScript. If you don't see the editor, enable JavaScript and reload.

Or from your terminalAutomate it with the API

npx mdedit-cli convert README.md --to docx

Same engine as this page. The command signs you in on first run.

Switch formats or reverse the workflow with a related converter.

Convert PDF to MarkdownRecover editable text from a text-based PDF with explicit fidelity limits.Convert Markdown to PDFTurn Markdown headings, lists, tables, and code into a printable PDF.Convert Word to MarkdownMove structured Word content into editable Markdown.

How to use Markdown to Word

1Upload a .md or .markdown file, or paste the source directly into the editor.
2Select “Convert” to build the .docx file.
3Download the finished .docx file.

Details

Markdown structures exported to Word

Standard Markdown becomes editable Word document structure, including headings, paragraphs, emphasis, links, ordered and unordered lists, blockquotes, fenced code blocks, and simple tables.

LaTeX math ( $...$ , $$...$$, and fenced math blocks) becomes native Word equations you can edit in Word’s equation editor, including fractions, integrals, align, and matrices.

The DOCX uses mdedit.ai’s reference document for baseline Word styles. You can continue editing those styles and the converted content in Word or another DOCX-compatible editor.

Tables, images, and code in DOCX

Simple Markdown tables become Word tables. Wide tables, very long cells, and advanced table syntax may need width or layout changes in Word.

Fenced code is exported as document content, but Word is not a syntax-highlighting runtime. Public HTTPS and data-URL images can be embedded on a best-effort basis; a relative image such as ./architecture.png is not uploaded with a standalone Markdown file.

Realistic Markdown to Word example

Example: an API migration guide contains # and ## headings, a numbered procedure, a compatibility table, links, and a fenced JSON response.

The DOCX keeps those elements editable for a reviewer. The reviewer should still check table widths, code wrapping, page breaks, and any image that came from an external URL.

Known Word export limitations

Markdown does not describe every Word feature. This converter does not create custom cover pages, tracked changes, comments, floating text boxes, macros, or a pixel-matched template.

Raw HTML, interactive content, custom CSS, and diagram source may not look like an editor preview. Open the DOCX and review styles, headings, tables, code, links, and images before sending it.

Math using commands Word equations cannot represent, such as an undefined macro or a TikZ drawing, stays in the document as plain LaTeX text instead of an equation.

Privacy and file limits

Markdown content is sent to mdedit.ai servers to create the Word document. Uploaded files and results are automatically deleted after 30 days.

Markdown files can be up to 10 MB. Conversion can fail when referenced resources are unreachable or when the document contains unsupported input.

Example

Convert Markdown to Word (DOCX).

Input (Markdown)

# Release Notes

The importer now streams large files instead of buffering them in memory.

```bash
mdedit convert notes.md --to pdf
```

| Change | Status |
| --- | --- |
| Streaming import | Shipped |
| Retry on 429 | In review |

Output (.docx)

Example.docx

Download

Last reviewed August 14, 2026

FAQ

What carries over from .md to .docx?: Structure maps across: headings, paragraphs, lists, links, tables, code blocks, and inline emphasis. Anything that depends on the source presentation layer can be simplified or dropped, including page layout, fonts and colors, comments and tracked changes, and deeply nested or merged tables. Review those areas before you publish the result.
What are the file limits?: Accepted file types are .md, .markdown. Each file must be 10 MB or smaller.
Is my content private?: Processed on mdedit.ai servers. Uploaded files are stored in a private S3 bucket (not publicly readable). Uploads use signed URLs, and results are provided via time-limited signed download links. Files are automatically deleted after 30 days.