适合谁
- 需要统一整理多种文件格式和网页内容的用户。
- 需要在本地 MCP 桌面应用中使用 Markdown 转换工具的用户。
- 能够配置 Bun、Node.js 和 Python 依赖的开发者。
M
50FMRS · D
这是一个 MIT 许可的社区 MCP 服务器，重点是把多种文件、网页内容和部分媒体内容转换为 Markdown。README 提供了构建、启动、桌面应用配置和路径限制说明，但未提供已验证的具体客户端兼容性列表或服务器清单。
Markdownify 是一个 Model Context Protocol（MCP）服务器，可将 PDF、图片、音频、DOCX、XLSX、PPTX、网页及部分搜索和视频内容转换为 Markdown，也可读取现有 Markdown 文件。
工具能力
youtube-to-markdown
将 YouTube 视频转换为 Markdown。
pdf-to-markdown
将 PDF 文件转换为 Markdown。
bing-search-to-markdown
将 Bing 搜索结果转换为 Markdown。
webpage-to-markdown
将网页内容转换为 Markdown。
image-to-markdown
将图片转换为包含元数据的 Markdown。
audio-to-markdown
将音频文件转录并转换为 Markdown。
docx-to-markdown
将 DOCX 文件转换为 Markdown。
xlsx-to-markdown
将 XLSX 文件转换为 Markdown。
pptx-to-markdown
将 PPTX 文件转换为 Markdown。
get-markdown-file
读取现有 Markdown 文件；文件扩展名必须为 .md 或 .markdown。
安装接入
克隆仓库；运行 bun install 安装依赖；运行 bun run build 构建项目；运行 bun start 启动服务器。桌面应用配置应将 command 设置为 node，并将 dist/index.js 的绝对路径放入 args。
claude_desktop_config.json
{"mcpServers":{"markdownify":{"command":"node","args":["{ABSOLUTE PATH TO FILE HERE}/dist/index.js"]}}}
选型与风险
不适合谁
- 只需要结构化数据库或云存储操作的用户。
- 需要已明确证明支持特定 MCP 客户端的用户。
- 使用精简 Docker 镜像且需要音频转录或图片 OCR 的用户。
所需权限
- 服务器需要读取传入的文件路径；可使用 MD_ALLOWED_PATHS 限制所有文件输入工具可读取的目录。
- 未设置 MD_ALLOWED_PATHS 时，文件读取范围默认不受限制。
- 处理网页、YouTube 或 Bing 内容的工具需要访问相应的网络内容；源材料未说明额外认证要求。
风险与副作用
- 默认文件读取范围不受限制，配置 MD_ALLOWED_PATHS 可缩小读取边界。
- Docker 发布镜像仅安装 markitdown[pdf]；音频转录和图片 OCR 工具在该精简镜像中会失败。
- 将本地目录挂载到 Docker 时，应只挂载需要读取的目录，并使用容器内路径。
常见排障
- 确认已运行 bun install 和 bun run build。
- 确认使用 bun start 启动服务器，并在客户端配置 dist/index.js 的绝对路径。
- 如 markitdown 不在默认虚拟环境中，检查 MARKITDOWN_PATH 或系统 PATH。
- 如 git-repo-to-markdown 相关功能异常，检查 REPOMIX_PATH 或系统 PATH。
- Docker 中确认工具使用的是容器路径，并检查 MD_ALLOWED_PATHS 是否包含挂载目录。
- 需要音频转录或图片 OCR 时，确认使用本地完整安装，而不是仅含 PDF 依赖的 Docker 镜像。
使用场景
将办公文档、PDF、演示文稿和表格转换为可读 Markdown。
从图片和音频中提取内容，其中音频支持转录。
将网页、YouTube 视频字幕或 Bing 搜索结果整理为 Markdown。
读取已有的 Markdown 文件。
支持客户端
暂未确认支持的客户端。