PDF Craft
PDF Craft 可将扫描版 PDF 书籍转换为可编辑的 Markdown 或适合阅读器阅读的 EPUB,并支持翻译 PDF 与 EPUB 文档,包括双语输出。
访问 oomol-lab/pdf-craft项目简介
PDF Craft 是面向扫描版 PDF 书籍、研究论文和技术文档的 Python 库与在线服务,可将扫描 PDF 转换为可编辑的 Markdown 或便于阅读器阅读的 EPUB。它还能翻译 PDF 与 EPUB 内容,生成仅译文或双语的 EPUB,并将译文写回原始 PDF 页面。转换过程可识别正文、章节、目录、脚注、表格、公式和图片,使内容在扫描页面之外也可搜索和编辑。
核心功能
- 将扫描版 PDF 转换为 Markdown,并保留文字与图片资源;生成带书籍元数据和目录的 EPUB,便于电子书阅读器使用;翻译 PDF 与 EPUB 文档,提供仅译文和双语 EPUB 模式;识别正文、章节、目录、脚注、表格、公式和图片;支持远程 OCR 与本地 OCR 配置,包括 DeepSeek OCR、DeepSeek OCR 2 和 Unlimited OCR;提供 Python API 与可复用的 .pcex 提取文件,供后续渲染或翻译。
适用场景
- 在手机或电子书阅读器上阅读扫描书,文字可调整并自动重排;将研究论文、教材或讲义转换为 Markdown,便于做笔记和摘录;翻译整本 EPUB 图书,并将译文与原文对照阅读;创建翻译版 PDF,把译文写回原始页面。
快速开始
- 可在浏览器中使用 PDF Craft Online:上传 PDF、提交转换任务,完成后下载结果,无需安装 Python、配置 CUDA 或设置 OCR 服务商。使用 Python 库时,需 Python 3.11–3.13 和 Poppler,并执行 python -m pip install pdf-craft 安装。配置兼容 DeepSeek OCR 的服务后,调用 craft.convert_pdf_to_markdown("input.pdf", "output.md") 生成 Markdown,或调用
部署与要求
- 在线转换只需浏览器,无需安装 Python 或设置 OCR 服务。Python 配合远程 OCR 需要 Python、Poppler、兼容的 OCR 服务 URL 和凭据。Python 配合本地 OCR 需要 NVIDIA GPU、CUDA、足够的显存和模型文件,并安装 pdf-craft 的 local 额外组件。创建翻译版 PDF 还需要 Ghostscript 和合适的本地字体。
采用前须知
- 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。