md2document
Guide

Markdown to DOCX — when the recipient needs to edit

A free in-browser converter that emits real .docx files. Same Markdown, same themes, same templates as the PDF flow — output is a Word document instead.

Elia Kuratli
By Elia Kuratli
·4 min read
Open the converter

When you want DOCX, not PDF

PDF is the right output when the document is final. It locks the layout, it prints the same on every machine, and reviewers leave comments without changing the source. DOCX is the right output when the recipient needs to edit — track changes on a contract, redline a memo, fill in a form, or drop the content into their own corporate Word template.

Most teams write the source in Markdown anyway. Switching to Word for the final version means losing the Markdown structure, fighting with the style ribbon and dealing with copy-paste artifacts. This converter skips that step.

How to convert Markdown to DOCX

  1. Open the converter.
  2. Pick a template. Paste your Markdown.
  3. Pick a theme — the theme controls fonts and color in the DOCX too.
  4. Switch the export toggle from PDF to DOCX, then click Export DOCX.

What the DOCX preserves

  • Heading levels — H1 to H6 map to Word's native heading styles.
  • Bold, italic, strikethrough, inline code, links — all rendered as character runs the way Word expects.
  • Tables with header rows.
  • Bulleted and numbered lists, including nesting.
  • Blockquotes (left border, italic body, accent color).
  • Code blocks with a tinted background and a monospaced font.
  • Cover page (when enabled) — a separate first page section.
  • Page numbers in the footer (when enabled).

What the DOCX does not preserve (yet)

Embedded images in the body are converted to text placeholders in v1 — [image alt] — because shipping browser-side image embedding for DOCX is a separate piece of work. If your document relies on inline images, export to PDF.

The header (top-right logo) is currently text-only in DOCX. The cover page still renders correctly with all metadata.

Theme fonts and DOCX

Each theme maps to a Microsoft-friendly font for the DOCX output: Calibri for Minimal/Editorial/Classic, Helvetica for Modern, Consolas for code blocks. That keeps the file rendering correctly even on machines without our bundled fonts.

FAQ

Does the DOCX file open in Microsoft Word?

Yes. We emit a standards-compliant .docx file that opens in Word, Apple Pages, Google Docs (via upload), LibreOffice and every other office suite that supports OOXML.

Are the styles preserved?

Headings, body, bold, italic, strikethrough, code, blockquotes and tables map to native Word styles. Colors and font choices follow the theme you pick. Page numbers go in the footer.

Why convert Markdown to DOCX instead of PDF?

When the recipient needs to edit. Lawyers, clients with comments, HR forms, peer review on a paper — all of these need a .docx because the receiver wants Track Changes, comments, or to drop the document into their own template.

Does the converter upload my Markdown?

No. The DOCX file is generated in your browser. The Markdown never leaves the tab.

Related

← All guides