How to Convert Markdown to Word (DOCX)

A step-by-step guide to turning any markdown document into a properly formatted Word .docx file — free, in your browser, with no upload required.

Why convert markdown to Word?

Markdown is the format of choice for developers, technical writers, and AI tool builders — it's plain text, version-controllable, and portable. But the rest of the world works in Word. Clients expect .docx files. HR departments, legal teams, and editors all work in Microsoft Word or Google Docs. Converting markdown to a Word document is the bridge between your workflow and theirs.

Common reasons to convert markdown to DOCX:

  • Sharing technical documentation with non-technical stakeholders
  • Submitting reports, proposals, or specifications to clients
  • Exporting AI-generated content (which often arrives as markdown) to editable documents
  • Providing colleagues with a Word file they can review and comment on
  • Archiving markdown notes in an industry-standard format

What gets preserved in the DOCX export

A good markdown-to-Word converter should carry over the full structure and formatting of your document, not just the plain text. Here's what the Markdown Utils converter preserves:

Headings (H1–H6)Converted to Word heading styles with proper size hierarchy and spacing.
Bold & italicInline strong and emphasis are mapped directly to Word bold and italic runs.
Ordered & unordered listsMulti-level lists with correct indentation. Task lists rendered with ☑ / ☐ characters.
TablesFull-width tables with header row shading, alternating row backgrounds, and column borders.
Code blocksMonospace font, background shading, and borders. Each language is preserved as a code block.
Inline codeMonospace font with background highlight, matching the code block style.
BlockquotesLeft accent border with background shading and proper padding.
Horizontal rulesConverted to a styled paragraph border.
LinksPreserved as clickable hyperlinks in the Word document.
ImagesFetched and embedded at up to 500px wide, centred.
Mermaid diagramsRendered to PNG and embedded as images.
Cover pageOptional — generated from the document's first heading and summary.
Table of contentsOptional — auto-generated from H1–H3 headings.
Page numbersOptional — added to the footer of each page.

Step-by-step: convert markdown to Word

1

Open the Markdown to Document converter

Go to markdownutils.com/markdown-to-docx/. No account, no install, no setup — it opens instantly in your browser.
2

Paste or upload your markdown

Paste your markdown directly into the left-hand editor pane, or click the Upload button in the toolbar to import a .md or .txt file. The right-hand preview updates in real time as you type.
3

Choose your theme

Pick from five document themes — Light, Dark, Sepia, Minimal, and Ocean. Each theme sets heading colours, table shading, code block tones, and accent colours. Even the Dark theme keeps a white page background — it changes accents and tones, not the paper.
4

Set your font, size, spacing, and margins

Choose a font (Calibri, Arial, Georgia, Times New Roman, Cambria, or Courier New), adjust font size (10–20pt), line spacing (1.2–2.5), and margin width (Normal, Narrow, Wide, or None). The preview on the right updates immediately.
5

Add a cover page and table of contents (optional)

Enable the Cover toggle to generate a cover page from your document's first heading. Enable ToC to auto-generate a table of contents from H1–H3 headings. Enable Numbers to add page numbers to the footer.
6

Export the DOCX

Click Export DOCX. Your browser downloads a .docx file immediately — named after your document's first heading. Open it in Microsoft Word, Google Docs, LibreOffice, or any compatible application.

Style and layout options explained

The style panel gives you fine-grained control over how the exported Word document looks.

🎨

Theme

Sets the colour palette for headings, tables, code blocks, blockquotes, and accents. Five options: Light, Dark, Sepia, Minimal, Ocean.

🔤

Font

Six fonts available: Calibri (default), Arial, Georgia, Times New Roman, Cambria, Courier New. Each is a native system font — no web font loading needed.

📐

Margins

Normal (1 inch / 25mm), Narrow (0.5 inch), Wide (1.5 inch), or None (5mm). Affects all four sides equally.

Spacing

Line height from 1.2× (compact) to 2.5× (double-spaced). Default is 1.5× — a comfortable reading rhythm for most documents.

🔡

Font size

10pt to 20pt in 1pt steps. Default is 11pt — the standard body size for Word documents.

📑

Cover page

Generated from your document's first H1 heading and the first paragraph as a subtitle. Includes the generation date.

📋

Table of contents

Auto-built from all H1, H2, and H3 headings in the body. Placed immediately after the cover page if both are enabled.

🔢

Page numbers

Added to the right side of the footer on every page.

Tips for the best results

  • Use a single H1 as your document titleThe first H1 heading becomes the document filename and the cover page title. Keep it concise and descriptive.
  • Structure with H2 and H3 for a clean ToCIf you plan to enable the table of contents, use H2 for major sections and H3 for subsections. The ToC only picks up H1–H3.
  • Calibri at 11pt is the Word defaultIf the recipient will be editing the document, Calibri 11pt matches the default style of a new Word document — making it blend in seamlessly.
  • Use Narrow margins for technical documentsTechnical docs with wide code blocks or tables benefit from Narrow margins — they give the content more room without changing font size.
  • Keep image URLs accessibleImages are fetched at export time. Use absolute URLs for images in your markdown. Local file paths won't work in a browser context.
  • Export warnings appear below the editorIf anything couldn't be fully converted (e.g. an image that failed to load), an export warning panel appears with details. Check it before sharing the document.

Frequently asked questions

Is this markdown to Word converter really free?

Yes, completely free. No account, no subscription, no watermarks, no page limits. The entire conversion runs in your browser using JavaScript.

Does my document get uploaded to a server?

No. The conversion happens entirely client-side. Your markdown text and the generated DOCX file never leave your device. There is no server involved.

Can I open the exported file in Google Docs?

Yes. Google Docs opens .docx files natively. Upload the file to Google Drive and open it with Google Docs. Most formatting — headings, tables, lists, and code blocks — will render correctly.

What markdown flavour does it support?

GitHub Flavored Markdown (GFM), which includes tables, task lists, strikethrough, fenced code blocks, and autolinks. Additionally, Mermaid diagrams and LaTeX math blocks are supported.

Can I convert a long document with many sections?

Yes, there are no length limits. For long documents, enabling the table of contents makes navigation much easier in Word.

The font in the preview looks slightly different from the export — is that a bug?

Not a bug. Microsoft fonts like Calibri and Cambria aren't available in browsers unless you have Office installed. The preview uses the closest web-safe equivalent. The exported DOCX will use the exact font you selected.

📝

Ready to convert your markdown to Word?

Paste your markdown and export a fully formatted .docx in seconds. No upload, no sign-up, fully private.