Skip to content
MCP server

Markdown to Word

Convert GitHub-flavoured Markdown to Word .docx files from Node, a CLI or an agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Web, CLI, self-hosted
Runs
Locally
Version
0.5.0
Listing updated
3 days ago

About Markdown to Word

Markdown to Word is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Everything runs locally. The same converter that powers md2word.app in the browser is published on npm as markdown-to-word, which works as a command line tool, a Node library and an MCP server over stdio. A quick use is npx markdown-to-word input.md. The site says files are never uploaded, stored or logged.

The converter handles GitHub Flavored Markdown: headings become Word heading styles, lists and nested lists become Word lists, task lists become checked and unchecked boxes, tables get thin borders with a repeating bold header row and keep column alignment, and code keeps its monospace and line breaks. Footnotes become superscript numbers with a numbered list at the end, not true Word footnotes. The first heading becomes the document title and file name.

A style for Chinese official documents following GB/T 9704-2012 is available in the web app, and its fonts must be installed where the file is opened. The author describes it as a successor to a 2015 Ruby gem and a mirror image of word2md.com, which converts the other way.

Install

Run in a terminal

claude mcp add markdown-to-word -- npx -y markdown-to-word

Add to claude_desktop_config.json

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": [
        "-y",
        "markdown-to-word"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": [
        "-y",
        "markdown-to-word"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "markdown-to-word": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "markdown-to-word"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": [
        "-y",
        "markdown-to-word"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": [
        "-y",
        "markdown-to-word"
      ]
    }
  }
}

What it does

Markdown to .docx
Produces formatted Word documents from GitHub Flavored Markdown.
Three ways to use it
Command line, Node library and stdio MCP server share one converter.
Table handling
Bordered tables with a repeating header row and preserved alignment.
Task list support
Checklist items become checked and unchecked boxes.
Local conversion
The web version runs in the browser and uploads nothing.
Chinese official style
Optional GB/T 9704-2012 formatting for 公文 documents.

Good for

  • Turn an AI chat reply into a Word document
  • Convert README or docs files for colleagues who use Word
  • Batch-convert Markdown notes in a script
  • Let an agent export a report as .docx
  • Paste formatted text into Google Docs

Pricing

Open source

Free and open source

Prices change. Check md2word.app before you buy.

Markdown to Word FAQ

How do I run it?

Use npx markdown-to-word input.md, or add it as a stdio MCP server from the npm package.

Are my documents uploaded?

No. The web converter works entirely in the browser and nothing is uploaded, stored or logged.

Which Markdown is supported?

GitHub Flavored Markdown: headings, emphasis, lists, task lists, tables, links, code, block quotes and rules.

Is it free?

Yes, it is free and open source, with no sign-up and no conversion limit.

Is Markdown to Word free?

Yes. Markdown to Word is open source, so you can use and self-host it for free.

How do I add Markdown to Word to Claude Code?

Run this command in your terminal: claude mcp add markdown-to-word -- npx -y markdown-to-word

What are the best alternatives to Markdown to Word?

The closest alternatives to Markdown to Word are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Markdown to Word

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media