markitdown 评测：微软出的文件转 Markdown 神器，一天涨了 1400+ Star

说实话，我收到微软开源了一个文件转 Markdown 工具的消息时，第一反应是：“这活不是已经有 Pandoc 了吗？” 但一看 GitHub Trending，一天涨了 1400 多星，12 万+ 的总 star 数，我决定还是试试。

这项目到底是干嘛的

markitdown 是微软开源的一个 Python 命令行工具，核心功能就一句话：把各种文件转成 Markdown。支持的格式包括但不限于：

• PDF（带文本层的）
• Word (.docx)
• PowerPoint (.pptx)
• Excel (.xlsx)
• HTML
• 图片（带 OCR 文字识别）
• 音频（带 Whisper 语音转文字）
• ZIP 压缩包（自动解压后递归处理）

最狠的是，它还能集成 OpenAI、Azure 等大模型 API，对转换结果做智能优化。比如把 PDF 里的表格转成结构化的 Markdown 表格，而不是一团乱码。

项目是用 Python 写的，MIT 协议，完全免费。127759 个 star，今天一天就涨了 1410，这个热度在微软的开源项目里也算排得上号了。

核心功能

多格式支持

我试了手边几个文件：一个 Word 合同、一个 PDF 论文、一个 PPT 演示文稿。转换效果让我有点意外——比 Pandoc 对中文的支持好很多，排版基本不乱。

Word 转出来的 Markdown 保留了标题层级和列表格式；PDF 如果是有文字层的，转换准确率相当高；PPT 会把每页转成带图片占位符的 Markdown 段落。

大模型增强

这是它跟 Pandoc 最大的区别。markitdown 可以调用 GPT-4 或 Azure OpenAI 来”理解”文档内容，而不是简单地把文字扒下来。

比如我转一个扫描版 PDF（没有文字层），它会先用 OCR 提取文字，再用大模型整理成结构化的 Markdown。表格、代码块、引用这些格式都能识别出来。

markitdown document.pdf --use-azure-openai

LangChain 集成

markitdown 内置了 LangChain 的 Document Loader，可以直接接入 RAG 流程。对做知识库、文档问答的团队来说，这意味着少写一堆预处理代码。

纯本地运行

不开大模型增强的话，markitdown 是完全本地运行的。不需要 API key，不联网，隐私敏感的文件也能放心处理。

实际使用场景

文档知识库建设：公司里堆积如山的 Word、PDF 文档，用 markitdown 批量转成 Markdown，再喂给向量数据库做检索。以前这个流程要写一堆脚本，现在一条命令搞定。

论文阅读：把 arXiv 下载的 PDF 转成 Markdown，配合 Obsidian 或者任何 Markdown 笔记软件做批注和整理。比直接在 PDF 阅读器里高亮要灵活得多。

内容迁移：博客从 WordPress 迁移到静态站点生成器（如 Hugo、Astro），markitdown 可以把导出的 HTML/Word 批量转成 Markdown，省大量手工调整的时间。

快速上手

pip install markitdown
markitdown input.pdf > output.md

如果需要 OCR 或大模型增强：

pip install markitdown[all]
markitdown scanned.pdf --use-azure-openai

优缺点分析

优点：

• 微软背书，维护有保障，更新很勤（今天刚更新）
• 中文支持明显比 Pandoc 好
• 大模型增强是杀手级功能，处理复杂文档效果惊艳
• LangChain 集成让接入 RAG 流程变得 trivial
• 纯本地模式保护隐私

缺点：

• 扫描版 PDF 的 OCR 质量取决于外部引擎，不算原生能力
• 大模型增强需要 API key，文档多了成本不低
• Excel 转 Markdown 的表格格式有时候会错位
• 对大文件（几百页 PDF）的处理速度偏慢
• 说实话，我还没拿它处理过上千页的文档，不确定极限性能

跟 Pandoc 怎么选

Pandoc 是老牌的格式转换瑞士军刀，支持的格式更多，社区生态更成熟。但 markitdown 在”文件→Markdown”这个垂直场景上做得更专、更智能。

如果你只是偶尔转个格式，Pandoc 够了。但如果你要处理大量文档、需要结构化输出、或者要做 RAG 知识库，markitdown worth a try。

适合谁用

• 需要批量处理文档转 Markdown 的知识库团队
• 做 RAG 应用需要文档预处理的开发者
• 想把本地文档整理成 Markdown 笔记的个人用户
• 内容迁移项目的工程师

开源协议 MIT，完全免费。需要 API 调用时才产生费用。

---

关于作者

柳钉鱼，全栈开发者，GitHub 重度用户。过去 3 年 Star 了 900+ 仓库，这里只写我真正用过或深度调研过的工具。

📧 发现好工具想推荐？发邮件到 [email protected]