Skip to content
MCP server

Word to Markdown

Convert Word .docx files to clean GitHub-flavored Markdown in browser, CLI or Node

Runs locallyStatus and history
Install
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-markdown

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

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

  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