用途:把文件、目录或 URL 转成干净的 Markdown,每个输入生成一个 .md,图片默认提取到同级 <stem>_files/。面向下游 PPT、Word、学习笔记等再生成流程,不承诺复刻原始版式。
主要能力:统一调度器自动识别类型,支持 PDF(本地 PyMuPDF 或 --mineru 云端 OCR)、docx/epub/html/ipynb、xlsx/xlsm、pptx 系列、srt/vtt/ass 字幕、网页 URL、txt 与已有 Markdown 直通。输出含图片 manifest、conversion_profile.json 等 sidecar;Excel 保留 15 位有效数字、百分比、前导零与合并单元格锚点,公式读取缓存结果。
使用方式:python3 scripts/convert.py <文件或URL> [...];本地单文件可用 -o 指定输出,多输入或目录时 -o 为输出目录。默认自然转换且保留全部图片;--raw 关闭启发式清理;--filter-images 过滤装饰小图;--no-images 不抽图。各后端也可独立 CLI 调用。安装:pip install -r resources/requirements.txt,再用 python3 scripts/check_env.py 检查环境。
适用场景:文档批量转 Markdown、网页正文提取、课程字幕整理、Office 表格与幻灯片内容再生成。
限制:不保留页边距、动画、主题与版式坐标;.xls 和旧版 .ppt 需先另存为 .xlsx/.pptx;.doc 依赖 pandoc;MinerU 需 MINERU_API_TOKEN;网页图片授权状态默认 unknown,交付前需自行审查;超过约 200 页的 PDF 建议先拆分。