用途:Docling CLI 用于将文档转换为结构化格式,具备智能解析、OCR 与 AI 增强能力,适合处理 PDF、DOCX、PPTX、图片等文件,输出 Markdown、JSON、HTML 等格式。
安装:uv tool install docling[asr,vlm]
目录准备:在项目根目录创建 import 与 export 目录,import/ 放源文件,export/ 放转换结果。可用 --output 指定任意输出目录。
主要能力与默认行为:输入格式自动检测(PDF、DOCX、PPTX、图片等);默认输出 Markdown;默认输出到当前目录;OCR 默认启用;表格提取默认启用;图片默认以 embedded 方式内嵌。
基本用法:先查看完整选项 docling --help。转换 PDF 为 Markdown:docling --output export/ import/document.pdf。转换为 JSON:docling --to json --output export/ import/document.pdf。批量转换整个目录:docling --output export/ import/。
图片导出模式:placeholder 仅标记图片位置;embedded 为 Base64 内嵌(默认);referenced 导出为 PNG 文件并在文档中引用。示例:docling --to json --image-export-mode referenced --output export/ import/document.pdf。
平台优化:macOS / Apple Silicon 建议使用 VLM 流水线,对扫描版 PDF 或含图片文档效果更好:docling --pipeline vlm --output export/ import/document.pdf。VLM 流水线默认模型对含中文图片内容的文档表现良好。
音频转写:使用 ASR 模型把音频转为文本。默认 whisper_tiny:docling --pipeline asr --output export/ import/audio.mp3。中文更高准确率可用 whisper_large:docling --pipeline asr --asr-model whisper_large --output export/ import/audio.mp3。
限制:资料未提供具体支持格式的完整清单、各模型资源占用、转换准确率、收费与价格、平台兼容范围等信息,暂未提供。