markdownify-mcp
活跃·★ 3.0k·MIT·更新于 2026-10-26
★ 必备神器★ 时下流行
Markdownify 是一个 MCP 服务，把多种内容转换成 Markdown，方便 AI 模型阅读。它能处理 PDF、图片（含元数据）、音频（含转写）、DOCX、XLSX 和 PPTX 文件，以及网页内容：YouTube 视频字幕、Bing 搜索结果和普通网页。另有 `get-markdown-file` 工具用于读取已有的 .md 或 .markdown 文件，可选的环境变量 `MD_SHARE_DIR` 能限制它可读取的目录。
安装需要从源码开始：克隆仓库，运行 `pnpm install`（会同时安装 `uv` 和相关 Python 依赖）、`pnpm run build` 和 `pnpm start`，然后在桌面应用的 MCP 配置里用绝对路径指向 `dist/index.js`。工具定义在 `src/tools.ts`，服务在 `src/server.ts`，要增加转换器就改这两个文件。README 开头有一条求助：需要有 Windows 电脑的人帮忙测试 Windows 支持，因为已有的 PR 维护者无法测试。许可证为 MIT。
#MCP服务器#Markdown转换#文档处理#网页抓取#文件转换器
01
功能特性
01将PDF、图片、音频（带转录）、DOCX、XLSX、PPTX转换为Markdown
02将YouTube视频转录、Bing搜索结果和通用网页转换为Markdown
03从指定目录检索现有Markdown文件
04模型上下文协议（MCP）服务器集成
05支持`uv`和Python依赖项进行底层转换
02
为什么选择它
+一个服务就覆盖 PDF、Office 文件、图片、音频和网页
+包含音频转写和 YouTube 字幕
+可用 `MD_SHARE_DIR` 限制读取文件的目录
+代码量小，工具集中在一个文件里，容易扩展
03
权衡点
!README 没有提供打包好的发布版：需要克隆、构建，再让客户端指向本地路径
!Windows 支持未确认，维护者在找人帮忙测试
!`pnpm install` 还会装 `uv` 和 Python 依赖，两套工具链都要有
!README 没有说明具体用哪些库做转换，也没说明复杂排版的处理效果
05
维护状况检查
放缓检查日期: 2026-10-27
- 最近提交
- 2026-05-01
- 近 90 天提交数
- 0
- 近 90 天发布数
- 0
- 最新发布
- v1.1.0 (2026-05-01)
- 未关闭 issue
- 31
- 近期 issue 至少有一条评论的比例
- 3/14
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #95 webpage-to-markdown fails on Apple Silicon (ARM) — onnxruntime CPU warning + crash5 条评论 · 2026-04-10
- #148 Added 1-click config generator and setup guide for markdownify-mcp on MCP ServerList0 条评论 · 2026-10-20
- #139 [audit N6] write_* family has empty default allowed_directories — discuss default-deny0 条评论 · 2026-08-29
- #138 [audit N5] stderr from repomix is silently dropped (informational)0 条评论 · 2026-08-29
- #137 [audit N4] inferExtensionFromUrl ignores ?query and #fragment0 条评论 · 2026-08-29
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 想要一个简单的服务器，把 PDF、Office 文件、图片、音频和网页转成 Markdown，包括 YouTube 字幕。
- 想自己扩展：所有工具都在 `src/tools.ts` 这一个文件里。
- 想用 `MD_SHARE_DIR` 限制文件读取范围。
建议换别的情况
- 你想要打包好的安装方式：需要克隆、构建，再把客户端指向本地路径。
- 你用的是 Windows：尚未确认支持，维护者在找人帮忙测试。
- 你在意复杂排版：README 没说明用的是哪些转换库，也没说明它们怎么处理复杂排版。
06
与同类的区别
07
兼容性
Model Context Protocol (MCP)
原生支持
已通过文档验证
Desktop Apps (MCP enabled)
支持
已通过文档验证
Node.js
原生支持
已通过文档验证
Python Environment (via uv)
支持
已通过文档验证
Windows
部分支持/需要帮助
已通过文档验证
08
快速开始
1
$ pnpm install
09
使用场景
↳为AI模型上下文准备多样化内容（文档、网页）
↳以标准Markdown格式归档网页内容或多媒体
↳自动化将各种文件类型转换为统一文本格式
10
同类工具
收录于以下清单
评论
登录后发表评论
暂无评论，来发表第一条吧