### [【开源推荐】markitdown：150K+ Stars！微软开源文档转Markdown神器，LLM管道必备](https://www.willai.cc/article/1586)

**Published:** 2026-06-11T05:17:46

**Author:** hiyoho

**Excerpt:** MICROSOFT 开源 markitdown 150K+ Stars · 将任意文档一键转换为 Markdown Python 3.10+ MIT 开源 LLM 友好 📌 项目简介 markitdown 是微软出品的一款轻量级 Pytho

MICROSOFT 开源

# markitdown

150K+ Stars · 将任意文档一键转换为 Markdown

Python 3.10+  
MIT 开源  
LLM 友好

📌 项目简介

markitdown 是微软出品的一款轻量级 Python 工具，支持将 PDF、PowerPoint、Word、Excel、HTML、CSV、JSON、音频、视频等 **数十种文件格式** 统一转换为 Markdown 格式，是大模型文档处理管道中的核心基础设施。

## ⚙ 安装要求与过程

环境要求

-   Python 3.10 及以上版本
-   推荐使用虚拟环境（venv / uv / conda）
-   pip 21.0+（用于安装可选依赖组）

快速安装（全格式支持）

```
# 全量安装（推荐）
pip install 'markitdown[all]'

# 命令行直接使用
markitdown document.pdf > output.md

# Python API 使用
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
```

按需安装（减少依赖体积）

```
pip install 'markitdown[pdf, docx, pptx]'   # 仅 PDF/Word/PPT
pip install 'markitdown[youtube-transcription]'  # 仅 YouTube 字幕
```

## ★ 核心功能

📄 多格式支持

PDF、Word、PPT、Excel、HTML、CSV、JSON、XML、EPUB、ZIP，覆盖办公全场景

🖼️ 图片 & 音频

图片 EXIF 元数据提取 + OCR，音频语音转写，视频字幕自动获取

🤖 LLM 集成

可调用 GPT-4V 等大模型为图片/幻灯片生成描述，增强多模态理解

🔌 插件扩展

支持第三方插件（如 markitdown-ocr），社区插件标签 #markitdown-plugin

☁️ Azure 集成

支持 Azure Document Intelligence 和 Azure Content Understanding，企业级文档解析能力

## ▶ 典型使用场景

场景一：RAG 知识库文档预处理

在构建 RAG（检索增强生成）应用时，需要将企业内部的 PDF 手册、Word 文档、PowerPoint 课件统一转换为 Markdown，再切片嵌入向量数据库。markitdown 一条命令批量处理，保留标题层级和表格结构，大幅提升检索精度。

```
for f in docs/*.pdf; do
  markitdown "$f" -o "md/${f%.pdf}.md"
done
```

场景二：LLM 文档理解管道

将用户上传的任意格式文档（简历、合同、报告）转换为 Markdown 后传给 LLM 进行分析、摘要或信息提取。markitdown 的 Markdown 输出对 Token 消耗远低于原始二进制格式，降低成本。

```
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("contract.docx")
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role":"user","content":f"摘要：{result.text_content}"}]
)
```

## 💡 推荐理由

作为一名经常和 LLM 打交道的开发者，markitdown 已经成为我工具箱里的**常驻成员**。它的价值在于**把”任意文档”变成”LLM 能理解的文本”**，这在大模型应用开发中是一个高频且痛点的需求。

最让我惊喜的是它的**格式保留能力**——转换后的 Markdown 仍然保留表格结构、标题层级和链接，这直接决定了 RAG 检索的质量。相比之下，很多同类工具转换后就只剩纯文本了。

来自微软 AutoGen 团队的维护保证，加上 150K+ Stars 的社区验证，这款工具的可靠性和迭代速度都非常值得信赖。如果你正在做任何涉及文档处理的大模型应用，markitdown 绝对是不二之选。

## 📥 下载地址

[GitHub 仓库](https://github.com/microsoft/markitdown)  
[PyPI 页面](https://pypi.org/project/markitdown/)  
[官方文档](https://github.com/microsoft/markitdown/blob/main/README.md)

由 AI 自动整理，更多开源项目介绍持续更新中 🚀

**Tags:** AI, AI开源项目, CLI工具, GitHub, LLM, Markdown, Microsoft, Python, RAG, 人工智能

**Categories:** 开源项目

---