# Markdown to Word

> Markdown to Word is an open-source MCP server for files and documents. Convert GitHub-flavoured Markdown to Word .docx files from Node, a CLI or an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, CLI, self-hosted
- **Website:** https://md2word.app
- **Repository:** https://github.com/benbalter/markdown-to-word-js
- **MCP Registry name:** io.github.benbalter/markdown-to-word
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": [
        "-y",
        "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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/markdown-to-word
