MarkItDown

概述

MarkItDown 是 Microsoft 的轻量级 Python 工具，用于将常见文档转换为保留结构的 Markdown。其输出主要面向索引、文本分析、搜索和 LLM 摄取，而非高保真度的视觉复现。

本技能针对 MarkItDown 0.1.6，发布于 2026 年 5 月 26 日。新代码应使用 result.markdown；result.text_content 仅作为软弃用的兼容性别名保留。

选择正确的路径

需求	推荐路径
可信的本地 PDF、Office、HTML、CSV、EPUB 或 ZIP	使用 convert_local() 的内置转换器
已上传的字节或已打开的文件	使用 convert_stream()，配合 StreamInfo 提示
远程 HTTP(S) 输入	自行验证并获取，然后调用 convert_response()
扫描版 PDF 或嵌入图像中的文字	官方 markitdown-ocr 视觉插件、Azure Document Intelligence 或 Azure Content Understanding
视频、结构化字段或自定义多模态抽取	Azure Content Understanding
本地代理集成	通过 STDIO 或 localhost 的官方 markitdown-mcp 服务器
边界框、页面坐标或截图	使用支持版式感知的解析器，例如 LiteParse
PDF 合并/拆分/表单/水印	使用 pdf 技能

安装

创建隔离环境：

uv venv --python 3.12 .venv
source .venv/bin/activate

安装所有内置特性：

uv pip install "markitdown[all]==0.1.6"

或者仅安装任务所需的转换器：

uv pip install "markitdown[pdf,docx,pptx,xlsx]==0.1.6"

0.1.6 中可用的扩展包括：

• pptx、docx、xlsx、xls、pdf 和 outlook
• audio-transcription 和 youtube-transcription
• az-doc-intel 和 az-content-understanding
• all

验证安装：

markitdown --version
python scr…