PDFMathTranslate 入门指南：1 条命令翻译 PDF 论文，公式与排版原样保留

PDFMathTranslate 入门指南1 条命令翻译 PDF 论文公式与排版原样保留【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslatePDFMathTranslate 是一款开源 PDF 科学论文翻译工具一条命令把英文论文翻成中文公式、图表、目录和版面位置原样保留一次产出纯译文与双语对照两份 PDF。它面向批量阅读外文文献的研究者、学生和文献翻译工作者解决普通翻译工具把公式打散、双栏排版弄乱的问题。 先看效果翻译后你会得到 2 个 PDF翻译跑完后当前目录会生成两个文件document-mono.pdf纯译文和document-dual.pdf中英对照。它先用 DocLayout-YOLO 模型检测版面识别出文字、公式、图片各自的区域再把翻译结果写回原位所以公式不会被拆成乱码双栏结构也不会错乱。 3 行命令跑起来安装并完成第一次翻译环境要求Python 3.11 或 3.12。下面第 1 条命令安装工具第 2 条翻译当前目录下的document.pdfpip install pdf2zh pdf2zh document.pdf跑完你会看到当前目录多出一个document-mono.pdf和一个document-dual.pdf用 PDF 阅读器打开确认公式和版面无误即算跑通。默认翻译服务是 Google无需配置任何密钥。⚙️ 一张表看全 5 个高频操作操作适用场景命令单篇翻译翻译一篇论文pdf2zh document.pdf批量翻译目录一个文件夹里多篇文献pdf2zh --dir ~/papers只翻部分页先试翻几页看效果pdf2zh document.pdf -p 1-3,5指定源/目标语言英译日等其他语种pdf2zh document.pdf -li en -lo ja换翻译服务用 DeepL、OpenAI、Ollama 等pdf2zh document.pdf -s openai两个不敲命令也能用的入口适合不想接触终端的场合网页 GUI这条命令会启动本地服务并自动打开浏览器你在页面上上传 PDF、选服务、点翻译即可浏览器没自动弹出时手动访问http://localhost:7860/pdf2zh -iDocker 容器不想装 Python 时下面两条命令会拉取镜像并启动服务跑完访问同样的 7860 端口即可使用适合团队共用一台服务器docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zhWindows 上还有免安装的pdf2zh.exe从发布页下载压缩包解压后双击运行即可完全不需要 Python 环境。 最常改的 4 个进阶配置配置项作用建议值-t翻译并发线程数42~8 之间--config把常用设置存成 JSON 文件每次自动读取config.json--ignore-cache忽略翻译缓存强制重新调用 API换服务或换语言后加--prompt自定义 LLM 翻译提示词prompt.txt--skip-subset-fonts关闭字体子集化阅读器显示异常时加--mode翻译内核版本precisev2实验性--babeldoc改用 BabelDOC 后端翻译配合-s openai使用-f/-c用正则指定保留的公式字体和字符默认已覆盖常见数学字体最关键的三个-t控制速度长文档建议开 4 以上--config会把~/.config/PDFMathTranslate/config.json里的服务密钥、默认语言一次配好之后命令里就不用带参数--ignore-cache在你改了设置但输出还是旧内容时用。其余配置各翻译服务需要哪些环境变量、自定义提示词变量、MCP 配置都写在 docs/ADVANCED.md 的表格里配服务前查一遍能省很多排查时间。 新手最常问的 4 个问题问首次运行卡住很久一直没有任何输出答先把网络指向镜像源再跑加两行命令即可如下export HF_ENDPOINThttps://hf-mirror.com pdf2zh document.pdf原因是首次运行要从模型仓库下载 DocLayout-YOLO 版面检测模型访问不到官方源就会卡住或超时PowerShell 里写法是$env:HF_ENDPOINT https://hf-mirror.com。问明明换了语言或翻译服务输出的内容却和上次一样答加--ignore-cache重翻即可。程序对相同文本做了翻译缓存避免重复调用 API设置变化不会自动失效缓存。问输出文件在某些 PDF 阅读器里中文显示为空白或方框答加--skip-subset-fonts重新翻译。默认开启的字体子集化功能用于压缩文件体积但和个别阅读器不兼容。问Windows 上下载的 exe 双击没反应或闪退答先安装微软官方的 VC 运行库vc_redist.x64.exe再双击。缺运行库是这个版本最常见的崩溃原因。 资源导航3 条深入路线docs/ADVANCED.md全部参数说明以及 20 多种翻译服务各自需要的环境变量和默认模型配服务前必查docs/APIS.mdPython 接口与 HTTP 接口用于把 PDF 翻译能力接进你自己的程序pdf2zh/kernel/核心源码翻译内核与版面解析的实现都在这层目录里。建议下一步先用 CLI 翻一篇你熟悉的论文对照原文确认公式和双栏版面没有跑位再把常用的服务写进--config配置文件之后批量目录翻译就只剩一条命令。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考