3 分钟跑通 PDFMathTranslate：保留排版的 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/PDFMathTranslate
外文 PDF 一翻译，公式变乱码、图表跑偏、目录直接消失——读文献时很少有人没被这种糟心事卡过。PDFMathTranslate 就是冲着它来的：一个能保留排版的 PDF 翻译工具，一条命令就能把整篇论文翻成中文，公式、图表、注释都留在原位。下面按“第一次用 → 跑通 → 踩坑”的顺序，带你把它真正用起来。
翻译前后左右对照：左侧英文原文、右侧中文译文，公式编号和双栏结构都还在原位。
第一次翻译：一条命令出中文版
第一次用你不需要懂任何原理，记住一件事就够：装完直接跑，先出结果再谈优化。
它依赖 Python 3.10~3.12。装好之后有两个入口，图形界面适合不想敲命令的人，命令行适合熟练工：
pip install pdf2zh pdf2zh -ipdf2zh -i会启动图形界面，浏览器打开 http://localhost:7860 就能用：把 PDF 拖进去、选引擎、点翻译，右侧实时出预览。
图形界面流程：拖入文件、选 DeepLX 引擎、选翻译页数，点 Translate 即可。
如果你更习惯终端，下面两条是最常用的起点——第一条默认走 Google 翻译，第二条换成 DeepL：
pdf2zh your_document.pdf pdf2zh your_document.pdf -s deepl用图形界面翻译一篇 Nature 论文，网络图、公式和脚注在译文里全部原位保留。
公式、图表、目录翻译后还在原位，靠的是它先把每块内容的版面位置定位好，再往里回填译文，而不是整段重排——这也是它和普通翻译工具拉开差距的地方。
Docker 起一个团队共享的翻译服务
如果你不想在本机装 Python 环境，或者想把翻译能力开放给整个团队，Docker 是更省事的路线：拉镜像、起容器，服务就挂在 7860 端口上。
docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh起来之后浏览器访问 http://服务器IP:7860，团队成员共享同一个翻译入口，各自上传各自的文件。把本地部署 PDF 翻译这件事挪到服务器，也就这两行的事。
常用参数：换引擎、只翻几页、批量处理
能跑通之后，真正高频的其实是几个参数，平时来回用的就是它们：
pdf2zh your_document.pdf -p 1-5 # 只翻第 1~5 页 pdf2zh large_document.pdf -t 4 # 用 4 个线程提速 pdf2zh complex_document.pdf --compatible # 复杂排版走兼容模式 pdf2zh --dir /path/to/your/papers/ # 批量翻译整个目录-p决定翻哪几页，-t控制线程数（默认就是 4），--dir让你一次喂进去一整个文献目录，跑批的时候省事。参数想再往深里调——术语词典、字体、代理设置——去看 docs/ADVANCED.md，那里是完整的参数清单。
🔧 翻不动时查这里：两个高频坑
翻不动的时候先别怀疑自己，下面这两个坑占了一大半情况，对号入座就行。
第一个坑是模型下载失败。运行时它会从 Hugging Face 拉布局解析模型，网络不通就卡在下载这一步。换个镜像端点再试：
export HF_ENDPOINT=https://hf-mirror.comWindows PowerShell 里写成$env:HF_ENDPOINT = "https://hf-mirror.com"，效果一样。
第二个坑是复杂排版翻出来花了。多栏、脚注、混排公式的文档，加--compatible走兼容模式，它会把 PDF 先转成 PDF/A 再处理，兼容性更稳。
更多功能、API 集成和 Zotero 插件的用法，直接翻 docs/README_zh-CN.md 对照着看。下一步如果你打算把它接进自己的文献工作流，建议先把-s换成自己最常用的引擎，再用-o把输出目录固定下来，跑成一条稳定的管线。
【免费下载链接】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），仅供参考
