用途:将多种文件格式转为 Markdown,方便交给大语言模型或文本分析流程使用,保留标题、列表、表格与超链接等文档结构,输出简洁、省 token,不生成临时文件。
主要能力:文档转换(PDF、DOCX、PPTX、XLSX、XLS),媒体处理(图片 OCR 与 EXIF 元数据、音频转录,需 speech_recognition),网页内容提取(HTML、YouTube 视频转录、EPUB、RSS),结构化数据(CSV、JSON、XML 转为可读 Markdown 表格),以及 ZIP 压缩包的批量转换。
使用方式:Python 调用示例 from markitdown import MarkItDown; md = MarkItDown(); result = md.convert("document.pdf"); print(result.text_content)。命令行示例 markitdown document.pdf -o output.md。批量处理脚本:python scripts/batch_convert.py /path/to/documents /path/to/output。安装可用 uv pip install 'markitdown[all]',也可按功能模块安装,如 uv pip install 'markitdown[pdf]'、uv pip install 'markitdown[docx]'、uv pip install 'markitdown[pptx]'、uv pip install 'markitdown[xlsx]'、uv pip install 'markitdown[audio]'、uv pip install 'markitdown[youtube]'。
高级集成:可接入 Azure Document Intelligence 以增强 PDF 表格提取与版面分析;可用 LLM(如 gpt-4o)生成图片描述。插件默认出于安全考虑被禁用,需显式设 enable_plugins=True。运行环境要求 Python 3.10 或更高。
适用场景:为 RAG 准备知识库文档、构建文档分析流水线、把手册/指南/FAQ 等资料统一转为 Markdown 再做嵌入与索引。
限制:音频转录依赖额外的 speech_recognition 组件;部分高级能力需要 Azure 或 LLM 服务的凭据;其他收费、价格与平台信息暂未提供。