A
licenseA
qualityB
maintenanceMCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, PDF, DOCX (.docx), csv and more.
1
582
MIT
x2md
by fengredrum
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@x2mdconvert /home/user/report.docx to markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
x2md
将 .docx 文件转换为 Markdown，支持图片提取和 HTML 表格转换。提供 MCP server 和 Python API 两种使用方式。
安装
uv syncRelated MCP server: Any2Markdown MCP Server
使用方式
1. MCP Server
启动 MCP server（stdio 传输）：
uv run x2md-mcpMCP 工具
convert_docx_to_markdown
参数 | 类型 | 默认值 | 说明 |
|
| 必填 |
|
|
| 与文档同目录 | 输出目录， |
|
|
| 是否提取嵌入图片并修复引用 |
|
|
| 是否将表格转为 HTML（保留 colspan/rowspan） |
返回：转换摘要，包含输出路径、文件大小、提取的图片数量。
配置 MCP 客户端
在 Claude Code 的 ~/.claude.json（或 settings.json）中添加：
{
"mcpServers": {
"x2md": {
"type": "stdio",
"command": "uv",
"args": ["run", "--directory", "/home/oblivion/GitHub/x2md", "x2md-mcp"]
}
}
}注意：
"type": "stdio"是必填字段，缺少会导致 MCP server 被静默忽略。配置后需重启 Claude Code 才能生效。
2. Python API
from x2md.converter import convert
# 基础转换（输出与原文件同目录）
result = convert("/path/to/document.docx")
# 指定输出目录
result = convert("/path/to/document.docx", output_dir="/path/to/output")
# 禁用图片提取和 HTML 表格
result = convert(
"/path/to/document.docx",
extract_images_flag=False,
html_tables=False,
)
print(result) # → 输出的 .md 文件路径3. 原有 CLI
docx2md.py 仍可直接使用：
uv run python docx2md.py <input.docx> [options]转换流程
.docx ──[markitdown]──> .md ──[图片修复]──> .md ──[HTML表格]──> .md图片：提取到
images/<文档名>/fig_1.png, fig_2.png, ...，修复 Markdown 中的引用表格：解析 DOCX 原始 XML，转为带
colspan/rowspan的 HTML<table>，粗体/斜体格式保留
依赖
Python >= 3.10
markitdown — .docx → .md 转换
mcp — MCP server 框架
通过
uv管理所有依赖，使用阿里云 PyPI 镜像
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Generate PDF, Word (.docx) and PowerPoint (.pptx) documents from Markdown over MCP.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConverts PDF, Word, and Excel documents to Markdown with image extraction and header/footer removal via MCP or REST API.50MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for converting various file formats (PDF, DOCX, images, audio, etc.) to Markdown using Microsoft MarkItDown, with support for large files and Cyrillic text.1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for converting between document formats (DOCX/PDF to Markdown and Markdown to DOCX) with academic styling support.20 PyPI1MIT
