夜雨聆风学习资料网

ARTICLE · 1141857

翻译后的 PDF,公式和排版都不乱:这个开源工具做到了

翻译后的 PDF,公式和排版都不乱:这个开源工具做到了

外文 PDF 难读,扔进翻译软件整页粘成 Word,公式变方框、表格错位、图也没了;逐段贴去 DeepL 翻得不错,但拿到的是散片文本——丢掉原文版式。看论文、看技术手册、看产品说明书的人,最缺的就是「保留版式」这一下。

PDFMathTranslate 干的是另一件事:保留 PDF 原版式,左原文右译文双列并排,公式、表格、图位置都不动。截至发稿仓库约 3.7 万 star,AGPL-3.0,从 2024 年起一直在更新。不是上一篇 pyvideotrans 那种视频翻译——这篇专门冲着 PDF 文档来。

先看效果

打开是一份英文论文,左半边原文不动,右半边中文逐句对应;公式编号 (1)、(2) 在两边对得上号,段落结构、图表位置、行间距都对齐。看不懂某句中文时,左边原文立刻能对——不用在两个窗口之间来回切。

一眼说给同事听,就是这句:扔一份外文 PDF 进去,得到一份保留版式的中文版,公式一个不乱。

它把 PDF 翻译做回了一件事

这是我留下它的理由。

保留版式,是字面意义的保留。 原文页面元素——段落、图表、脚注、引用——在译文页里位置不变;双列对照视图里左右行高对齐,读到哪里看哪段。这是「复制到 DeepL」做不到的。

公式按 LaTeX 重排,不会变方框。 PDF 里的显式公式(如 $\int_0^1 f(x),dx$)、行内符号、上下标,都按 LaTeX 重新排进右边译文列。这是它和y,按 token 计费)、本地 Ollama 跑开源大模型(完全离线,慢但不要钱)。支持的服务在 ADVANCED 文档里列齐了,包含 Bing(免 key、大陆可达)、DeepL 等。

保留元数据。 书签、目录、参考页码在译文里还在——全文读起来还是一份完整的 PDF,不是散页。

配角一个,同样值得说:

服务形态可选。 自带 Web UI(在线版 pdf2zh.com 就是官方部署的实例);命令行版按 pdf2zh sample.pdf 一行能跑;想自托管可以装 Docker。在线版适合偶尔翻一两份的,本地装适合天天翻的。

我的判断:谁该试,谁别碰

值得装的是这几类人:常读外文论文和tech 标准的学生和工程师、看外文产品说明书的人、想自托管做组织内 PDF 翻译的小团队。

但下面几条,我认为必须写在前头。

纯文字 PDF 用别的更快。 没公式也没图表的纯文字 PDF,DeepL 网页版逐段翻更顺手。本工具的价值在「版式 + 公式」二合一——纯文字场景优势体现不出来。

Google 后端大陆不通,第一次跑会卡住。 默认配置走 Google,国内用户首次跑会卡在翻译那一步。换法写在「怎么开始」里:要么走 Bing(免 key、大陆可达)、要么申请 DeepSeek API key、要么本地拉 Ollama 跑离线翻译。

首次跑要拉模型。 走 Ollama 离线路线的话,第一次要下大约几个 G 的模型权重——按网速十几分钟到半小时,下完之后翻译全在本地,不再联网。

命令行装走 pip,要 Python 3.9 以上。 不熟命令行的,先走在线版 pdf2zh.com 试手感,再决定要不要本地装。GUI 版和命令行版装同一个包,开 GUI 那一步文档里写了。

门槛不高:在线版打开即用,本地装一行 pip install pdf2zh 搞定。

怎么开始

零安装先试一份(在线版)

打开 https://pdf2zh.com ,拖一份外文 PDF 上去,选 Google 或 DeepSeek 翻译,几十秒拿到双列对照的下载链接。确认手感再决定要不要本地装。在线版文件需上传一次服务器,敏感文件建议走本地。

装本地版(命令行 + GUI 同一个包)

pip install pdf2zh
pdf2zh --gui

GUI 装好打开拖文件即可。Python 版本要求 3.9 以上。

换离线后端(Ollama 路线,国内推荐)

  1. 1.先装 Ollama:https://ollama.com
  2. 2.拉一个翻译可用的开源模型:ollama pull qwen2.5:14b(约 8GB,第一次下完之后不联网)
  3. 3.翻译换成:
    pdf2zh sample.pdf --service ollama --model qwen2.5:14b

DeepSeek 路线(可选,国内可申请)

注册 DeepSeek 开放平台拿到 API key,跑:

pdf2zh sample.pdf --service deepseek --auth <你的key>

前两步在线版十分钟能走完。成功标准:拿到一份左原文右译文的双列 PDF,公式和图表与原文两边对得上。装不上或翻译卡住,留言 系统版本 + 报错前半句,我一条条看。

项目地址

  • ✦项目名称:PDFMathTranslate
  • ✦GitHub:https://github.com/PDFMathTranslate/PDFMathTranslate
  • ✦在线版:https://pdf2zh.com
  • ✦Star:约 3.7 万(截至发文,以仓库为准)
  • ✦许可:AGPL-3.0

文档翻译这几年都跑到网页订阅和封闭客户端里去;能把 PDF 翻译装回本地、保留版式、还能换后端——反而成了稀缺路线。

如果你觉得今天的内容有帮助,点击上方账号名片关注我,每天更新精选开源项目,让你少走弯路。

相关学习资料