WaywardTools

Small tools. Local when they can be.

Markdown Word Swap

Markdown to Word

Your file never leaves this device. Conversion runs in your browser. The document itself is not uploaded.

1 · Choose a Markdown file

…or drop a Markdown file here

.md, .markdown, .mdown, .mkd · stays in this tab

2 · Convert

3 · Download

Choose a file to convert. It is not uploaded.

FAQ and format details
Why convert Markdown to Word?

A README, RFC-in-a-gist, or Obsidian research note often has to become a 'document' for a meeting. Markdown→DOCX preserves headings and tables well enough for review, which is the job, not desktop-publishing the original vault.

How this conversion runs

marked renders GFM to HTML. That hub is mapped onto Word Heading styles, list numbering, tables, and hyperlinks. Fenced code becomes a Courier paragraph. YAML front matter is skipped. Images referenced as ordinary URLs will not be fetched; data URLs or already-inlined HTML images can embed.

Keep in mind for Markdown → Word

You will not get your VS Code theme, callout plugins, or embedded Mermaid as diagrams. Footnote plugins are not GFM here. Wide Markdown tables become Word tables that may need Autofit. Math ($...$) stays as literal text unless it was already HTML.

After you have a Word file

Open in Word or Google Docs. Apply a template if the org requires it. If the reviewers only want a PDF packet, Markdown→PDF skips Word entirely. Keep the .md; regenerate the DOCX when the source changes rather than editing both.

Do GitHub alerts or admonitions convert?

Not as special Word styles. They come through as blockquotes or ordinary paragraphs depending on how they were written. Put important warnings in a heading if reviewers must not miss them.

Can collaborators edit the DOCX and round-trip to Markdown?

Poorly. Word will inject styles and runs that Turndown cannot reconstruct as your original Markdown. Treat the DOCX as a review copy, then fold comments back into the .md by hand.

This pair at a glance
Accepts
.md, .markdown, .mdown, .mkd
Writes
.docx · application/vnd.openxmlformats-officedocument.wordprocessingml.document
Read fidelity
high (Markdown → HTML)
Write fidelity
high (HTML → Word)
Source size
Plan for files under 3.8 MB

The file is read in this tab. It is not uploaded.

Something off with this pair? Send feedback.

About Markdown and Microsoft Word (Office Open XML)

Source file

Markdown

A lightweight plain-text syntax for structured writing that compiles to HTML. The lingua franca of README files, wikis, and note apps.

Markdown stores documents as readable plain text with a small set of punctuation conventions for headings, emphasis, lists, links, and code. GitHub-Flavored Markdown (GFM) adds tables, strikethrough, task lists, and fenced code blocks. Conversion through HTML is a natural fit because Markdown was designed as an HTML shorthand.

Extensions
.md, .markdown, .mdown, .mkd
MIME types
text/markdown, text/x-markdown
Kind
text · utf-8
Category
markup
Standard
Open format · since 2004
Comfortable size
Up to about 3.8 MB in this browser converter
Read into HTML
high fidelity · implemented — Parsed as GitHub-Flavored Markdown.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • code blocks
  • blockquotes

Usually dropped on the way in

  • raw html passthrough is sanitized

Apps that consume Markdown

  • GitHub (GitHub) — creates and opens on Web
  • Obsidian (Dynalist) — creates and opens on Windows, macOS, Linux, iOS, Android
  • VS Code (Microsoft) — creates on Windows, macOS, Linux
  • Typora — creates and opens on Windows, macOS, Linux
  • Notion — creates and opens on Web, Windows, macOS
  • Jupyter — creates and opens on Web
  • Discord — opens on Web, Windows, macOS, iOS, Android

Catalog notes

  • Front matter (YAML between --- lines) is preserved as a prefix when converting from Markdown, and ignored when converting to Markdown.
  • Obsidian wikilinks and footnotes have no lossless HTML equivalent yet.

Destination file

Microsoft Word (Office Open XML)

The default Word format since 2007: a ZIP package of XML parts for body text, styles, media, and document settings.

DOCX (Office Open XML WordprocessingML) replaced the binary .doc format. It is the interchange format for business documents: resumes, contracts, manuscripts. Word, Google Docs, LibreOffice, Pages, and OnlyOffice all read and write it. Macros live in a sibling .docm type, which this converter does not execute or emit.

Extensions
.docx
MIME types
application/vnd.openxmlformats-officedocument.wordprocessingml.document
Kind
zip · binary
Category
word processing
Standard
Open format · since 2006
Comfortable size
Up to about 24 MB in this browser converter
Written from HTML
high fidelity · implemented — A constrained HTML subset is mapped onto WordprocessingML runs and paragraphs.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • headers footers
  • styles
  • comments
  • track changes

Usually dropped on the way out

  • css positioning
  • custom fonts as linked webfonts
  • page layout

Apps that consume Word

  • Microsoft Word (Microsoft) — creates and opens on Windows, macOS, Web, iOS, Android
  • Google Docs (Google) — creates and opens on Web, iOS, Android
  • LibreOffice Writer (The Document Foundation) — creates and opens on Windows, macOS, Linux
  • Apple Pages (Apple) — creates and opens on macOS, iOS
  • OnlyOffice — creates and opens on Windows, macOS, Linux, Web
  • WPS Office (Kingsoft) — creates and opens on Windows, macOS, Linux, Android

Catalog notes

  • .docm, .dotx, and .dotm are not accepted; strip macros before converting.
  • ZIP sniffing is shared with ODT and EPUB — the engine also checks [Content_Types].xml for WordprocessingML.
Other conversions

Other conversions from Markdown: HTMLRTFOpenDocumentPDFEPUB

Other ways to get Word: HTMLRTFOpenDocumentPDFEPUB