用途：将异构文档与部分 URI 转为 Markdown，便于文本分析、搜索与 LLM/RAG 摄取。输出优先保留文本结构，不追求像素级还原。
主要能力：内置转换器支持受信任的本地 PDF、Office、HTML、CSV、EPUB、ZIP；支持字节流与已打开文件；远程 HTTP(S) 需自行校验抓取后调用 convert_response()。扫描 PDF 或图片内文字需官方 markitdown-ocr 视觉插件、Azure Document Intelligence 或 Azure Content Understanding。本地智能体集成可用官方 markitdown-mcp（STDIO 或 localhost）。
安装：uv venv --python 3.12 .venv；source .venv/bin/activate；uv pip install "markitdown[all]==0.1.8"，或按需安装 markitdown[pdf,docx,pptx,xlsx]==0.1.8。验证：markitdown --version。
用法：命令行 markitdown report.pdf -o report.md；Python 用 convert_local()、convert_stream()（配 StreamInfo）、convert_response()；convert_uri() 仅用于受信任且已校验的 URI。新代码使用 result.markdown，result.text_content 为软弃用别名。
限制与安全：转换文本应视为不可信数据，可能含提示注入或隐藏指令，不得直接执行。HTTP、音频转写、LLM 图像描述、OCR 插件与 Azure 服务会把内容发送到本地进程之外，需确认授权。插件默认禁用，启用前应审查来源。内置 PDF 转换器不本地 OCR。批量脚本仅接受本地文件，跳过符号链接。MCP 的 HTTP/SSE 模式无认证，应绑定 127.0.0.1。转换后需人工核对标题、表格、公式与图表，并保留原始文档为权威版本。