# Word to Markdown

Converts DOCX documents into clean Markdown, preserving tables, footnotes, and LaTeX equations. Useful for bringing Word files into repos.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 268
- Author: benbalter
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/benbalter/word-to-markdown-js
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/word-to-markdown

## What it does

This server parses `.docx` files and turns them into clean Markdown. It reads headings directly from Word paragraph styles, handles nested lists, and formats Office Math equations as LaTeX blocks or inline symbols. Tables and links remain intact, while footnotes become standard GitHub Flavored Markdown references. Images are embedded inline as base64 data URIs.

Processing runs locally on your machine via `npx`, keeping document contents on your device. Older `.doc` files will fail to convert; you must save them as `.docx` first. Headers, footers, and Word comments get stripped out during the conversion process.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add word-to-markdown -- npx -y word-to-markdown
```

### Codex

**Platform CLI**
```bash
codex mcp add word-to-markdown -- npx -y word-to-markdown
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "word-to-markdown": {
            "command": "npx",
            "args": [
                "-y",
                "word-to-markdown"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "word-to-markdown": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "word-to-markdown"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add word-to-markdown npx -y word-to-markdown
```

## When to use it
- convert DOCX files into Markdown documentation
- transform Word formulas into KaTeX and LaTeX blocks
- export Word tables and complex lists into plain text
- embed document images as base64 data URIs

## Example prompts
- Convert `specs/requirements.docx` to Markdown and write it to `docs/requirements.md`
- Extract the tables and equations from `analysis.docx` into Markdown format

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777
- [OpenTakeoff](https://affpapa.org/en/nevibecode/mcp/opentakeoff.md) — MCP server · ★ 667

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md