Word to Markdown
Convert Word .docx files to clean GitHub-flavored Markdown in browser, CLI or Node
- Pricing
- Open source
- Platforms
- Web, CLI
- Runs
- Locally
- Version
- 0.9.0
- Listing updated
- 2 days ago
About Word to Markdown
Word to Markdown is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Conversion runs on your own device. The website converts in the browser with no upload, and the same engine is available as npx word-to-markdown input.docx > output.md or as a Node library. The maker says it has been converting documents since 2014, and this version is billed as an improved rewrite of the original Ruby word-to-markdown.
It handles headings, bold, italic, strikethrough, superscript, nested lists, tables, links, footnotes and endnotes (as [^1] references) and equations (as LaTeX). Images are inlined as base64 by default, can be extracted to a folder, or dropped, and the web version offers a ZIP with an images folder. Several behaviors are options: numbered lists can become bullets, underline can be kept as a <u> tag, and curly quotes can be preserved or converted to ASCII.
Limits are documented. Comments, headers and footers are dropped (with warnings from convertWithWarnings), text boxes saved without Word's VML fallback are dropped, and only modern .docx is read, so older .doc files need re-saving first. Google Docs works through a Word download.
Install
Run in a terminal
claude mcp add word-to-markdown -- npx -y word-to-markdownAdd to claude_desktop_config.json
{
"mcpServers": {
"word-to-markdown": {
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"word-to-markdown": {
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"word-to-markdown": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"word-to-markdown": {
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"word-to-markdown": {
"command": "npx",
"args": [
"-y",
"word-to-markdown"
]
}
}
}What it does
- Browser conversion
- Drop in a .docx and copy or download the Markdown without uploading.
- Command-line use
- Run with npx for scripted or batch conversion.
- Image options
- Embed images, extract them to files or strip them.
- Footnotes and equations
- Footnotes become [^1] notes and equations become LaTeX.
- Conversion warnings
- convertWithWarnings reports dropped comments, headers and text boxes.
- Configurable output
- Choose bullet lists, underline handling and quote style.
Good for
- Turn a Word draft into Markdown for GitHub
- Prepare documents for LLM or RAG pipelines
- Batch-convert a folder of .docx files from a script
- Move a Google Doc into a Markdown repo
- Extract images from a Word file into separate files
Pricing
Open source
Free and open source
Prices change. Check word2md.com before you buy.
Word to Markdown FAQ
Is it free?
Yes, the site says it is free and open source with no sign-up, ads or conversion limit.
Are my files uploaded?
No. Conversion happens in your browser and files are never uploaded, stored or logged.
Can it read old .doc files?
No. Save them as .docx in Word first.
How is it different from Pandoc?
The site says it needs no install in the browser, while a CLI exists for batch work.
Is Word to Markdown free?
Yes. Word to Markdown is open source, so you can use and self-host it for free.
How do I add Word to Markdown to Claude Code?
Run this command in your terminal: claude mcp add word-to-markdown -- npx -y word-to-markdown
What are the best alternatives to Word to Markdown?
The closest alternatives to Word to Markdown are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.
Alternatives to Word to Markdown

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media