Word to Markdown for developers and agents

The converter behind word2md.com is free and open source and published to npm as word-to-markdown. Every way of running it, below, converts on your own machine; the converter uploads nothing. (With MCP or WebMCP, the agent does read the Markdown it gets back, as with any file you share with it.)

Claude Desktop (one click)

Download word-to-markdown.mcpb and double-click it. Claude Desktop installs the MCP server as an extension, so Claude can convert .docx files on your computer. You don’t need Node or a terminal: Claude Desktop includes Node. To install it another way, drag the file into Claude Desktop, or open Settings > Extensions > Advanced settings > Install Extension.

Command line

npx word-to-markdown report.docx > report.md
cat report.docx | npx word-to-markdown - > report.md
npx word-to-markdown -o out/report.md --image-dir images report.docx

Install it globally (npm install -g word-to-markdown) to get the shorter w2m command. The Markdown goes to stdout (or -o) and warnings to stderr. It exits 1 if the conversion fails. With --strict, it also exits 2 when the document has warnings. Other options cover bullets for numbered lists, underline, footnote style, equations, and images. See the full CLI reference.

Node library

import { convertWithWarnings } from 'word-to-markdown';

const { markdown, warnings } = await convertWithWarnings('report.docx');

It accepts a file path or an ArrayBuffer and ships TypeScript types. Errors are typed (UnsupportedFileError, InvalidFileError, and others) so you can show people a useful message. See the API reference.

MCP server for AI agents

npx -y word-to-markdown mcp runs a local Model Context Protocol server on stdio. Add it to Claude Code:

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

Or to any MCP client:

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

Its tool, convert_docx_to_markdown, takes the path to a .docx and returns the Markdown and any warnings. Images are dropped unless you pass image_dir, so base64 images don’t flood the agent’s context. output_path writes long documents to a file. The tool never overwrites an existing file unless you pass overwrite: true. See the MCP reference.

WebMCP in the browser

In a browser with WebMCP, word2md.com registers two tools for agents working in the tab: convert_docx_to_markdown, which takes a .docx as base64 and shows the result on the page, and get_converted_markdown, which returns what the person last converted. As with dropping a file, the conversion runs in the tab and nothing is uploaded. Images come back as image-omitted placeholders unless the agent passes include_images: true.

Open and Async MCP, from the same author, gives an agent async-first writing tools: draft a decision doc, swap a planned meeting for an async alternative, or score a status update. Once a team’s docs are in Markdown, it can draft new ones the same way.

claude mcp add open-async -- npx -y @open-and-async/mcp

For crawlers and LLMs

/llms.txt indexes the site, and /llms-full.txt has all of it in one file.
Every English page has a Markdown version: add .md (for example /developers.md), or request the page with Accept: text/markdown.

Source and self-hosting

The code is on GitHub under the Apache 2.0 license. The README explains how to run the site locally or host your own copy, with no analytics.

Convert a Word document to Markdown now. It's free, and nothing is uploaded.