夜雨聆风
昨天刷 GitHub，看到微软开源了一个项目，叫MarkItDown。
149,000 star。
它干的事很简单：把各种文件转成 Markdown。PDF、Word、PPT、Excel、HTML，都能转。
我第一反应是：这东西安全工程师能用上吗？写报告要贴客户给的 PDF 制度文件，转成 Markdown 再喂给 AI 总结，看起来正好对上。
01
MarkItDown 到底是什么定位
微软做这个工具的出发点很明确：给 AI 应用打底。
大模型训练和推理需要大量文本数据，但现实中的文档 PDF 占了大半。PDF 格式复杂，布局、字体、表格、图片混在一起，AI 直接读效果很差。
微软的思路：先把文件转成 Markdown，再喂给 AI。Markdown 是纯文本，结构清晰，标题是标题，列表是列表，段落是段落。
这个定位决定了它的优缺点，也决定了它适不适合你。
02
本地能跑吗？部署难度怎么样
完全支持本地运行，三种方式任选：
依赖要求：Python 3.10+，纯 CPU 也能跑（不需要 GPU）。
许可：MIT License，可自由用于商业项目，包括你给客户交付的工具。
SHELL · 安装命令
# 安装全功能版本pip install 'markitdown[all]'# 命令行单次转换markitdown file.pdf -o output.md
03
实测：PDF 转换质量到底怎么样
我用 3 类 PDF 测了 MarkItDown：
04
5 个竞品对比，哪个更适合安全工程师
我调研了 2026 年主流的开源 PDF 转 Markdown 工具，做了一次横向对比：
项目链接速查MarkItDown： github.com/microsoft/markitdownMinerU： github.com/opendatalab/MinerUMarker： github.com/VikParuchuri/markerDocling： github.com/docling-project/doclingPyMuPDF4LLM： github.com/pymupdf/pymupdf4llm
05
安全工程师怎么选：决策表
06
MarkItDown 的主要缺点
说了这么多，如果你决定用 MarkItDown，这几个坑要提前知道：
07
老宋说
// 老宋的话
技术本质
MarkItDown 的定位是 AI 文档预处理器，不是专业 PDF 转换工具。它的设计目标是「让 AI 能读」，不是「让人类能看」。这两个目标不完全一致。
行业观察
安全工程师越来越需要把各种格式的文档转成 AI 可处理的格式——客户需求文档、等保材料、安全方案，都是 PDF/Word。这个需求会长期存在，工具选择会影响效率。
对读者的建议
先明确你的主要场景是什么。如果主要转 Word/Excel，MarkItDown 够用且部署简单；如果主要转 PDF（尤其是中文 PDF），直接上 MinerU，省得后面踩坑重来。
往期精彩
