Word to Markdown — Claude Code MCP server: how to install
Converts DOCX documents into clean Markdown, preserving tables, footnotes, and LaTeX equations. Useful for bringing Word files into repos.
claude mcp add word-to-markdown -- npx -y word-to-markdownWhat Word to Markdown 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.
What it helps with
- 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 for the agent
- Convert
specs/requirements.docxto Markdown and write it todocs/requirements.md - Extract the tables and equations from
analysis.docxinto Markdown format
How to install Word to Markdown
Platform CLI
claude mcp add word-to-markdown -- npx -y word-to-markdownPlatform CLI
codex mcp add word-to-markdown -- npx -y word-to-markdownConfig file
{
"mcpServers": {
"word-to-markdown": {
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Config file
{
"servers": {
"word-to-markdown": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Platform CLI
gemini mcp add word-to-markdown npx -y word-to-markdownStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Word to Markdown
How to install Word to Markdown in Claude Code?
Run claude mcp add word-to-markdown -- npx -y word-to-markdown. Claude Code configures the MCP server using npx.
What does Word to Markdown do?
It converts .docx files into Markdown documents. The tool parses headings, tables, nested lists, and turns math equations into LaTeX notation.
Does it support legacy .doc files?
No, it only accepts .docx files. Any older .doc documents must be re-saved as .docx before running the conversion.
