绝对好使！35.6k星开源免费，PDF翻译格式老乱？这款完美保留排版！

科研论文翻译后公式图表全乱？排版崩坏看不下去？

科学 PDF 文档翻译及双语对照工具 PDFMathTranslate 的核心就狠在这

完整保留排版：公式、图表、目录、注释原样保留

AI精准翻译：支持多引擎，双语对照超清晰

本地一键跑：CLI/GUI/Docker全支持，隐私安全

科研友好：数学公式不翻坏，批量处理超省心

GitHub： https://github.com/Byaidu/PDFMathTranslate…

科研党、PDF 阅读者赶紧收，翻译论文再也不崩了！

#开源工具 #PDF翻译 #效率神器

PDFMathTranslate/PDFMathTranslate

Source: https://github.com/PDFMathTranslate/PDFMathTranslate

^{Special thanks to:}

Warp, built for coding with multiple AI agents
^{Available for macOS, Linux and Windows}

English | 简体中文 | 繁體中文 | 日本語 | 한국어

PDFMathTranslate

1. What does this do?

Scientific PDF document translation preserving layouts.

• 📊 Preserve formulas, charts, table of contents, and annotations.
• 🌐 Support multiple languages, and diverse translation services.
• 🤖 Provides commandline tool, interactive user interface, and Docker

2. Recent Updates

• [March 23, 2026] Experimental support for v2.0 translation kernel using isolated environment (--mode precise). (by @reycn)

• [March 22, 2026] Supporting MiniMax (PR by @octo-patch)

• [March 22, 2026] Fixing OpenAI-related issues (PR by @samqin123)

• [March 22, 2026] Fixing HTTP-related issues (PR by @soukouki)

• [March 22, 2026] Faster model loading on mac and OONX platforms, GUI starting-up, version printing, and continuous integration.(by @reycn)

• [May 9, 2025] pdf2zh 2.0 Preview Version #586: The Windows ZIP file and Docker image are now available.

  2.0 Moved to a new repository under the organization: PDFMathTranslate/PDFMathTranslate-next

  Version 2.0 official release has been published.

3. Use 🌟

3.1 Online Service 🌟

You can try our application out using either of the following demos:

• Public free service online without installation (recommended).
• Immersive Translate - BabelDOC Free usage quota is available; please refer to the FAQ section on the page for details. (recommended)
• Demo hosted on HuggingFace
• Demo hosted on ModelScope without installation.

Note that the computing resources of the demo are limited, so please avoid abusing them.

3.2 Local Installation

For different use cases, we provide distinct methods to use our program:

pip install pdf2zh

3.2.6 Docker: Containerized Deployment

1. Pull and run:

   docker pull byaidu/pdf2zh
   docker run -d -p 7860:7860 byaidu/pdf2zh
   

2. Open in browser:

   http://localhost:7860/
   

For docker deployment on cloud service:

• If you cannot access Docker Hub, please try the image on GitHub Container Registry.

docker pull ghcr.io/byaidu/pdfmathtranslate
docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate

set HF_ENDPOINT=https://hf-mirror.com

$env:HF_ENDPOINT = https://hf-mirror.com

4. Technical Details

4.1 Advanced options

Execute the translation command in the command line to generate the translated document example-mono.pdf and the bilingual document example-dual.pdf in the current working directory. Use Google as the default translation service. More support translation services can find HERE.

In the following table, we list all advanced options for reference:

For detailed explanations, please refer to our document about Advanced Usage for a full list of each option.

4.2 Downstream Development

• Python API, how to use the program in other Python programs
• HTTP API, how to communicate with a server with the program installed

4.3 Differences between two major forks

• Byaidu/PDFMathTranslate: The present and the original project for stable release.

• PDFMathTranslate/PDFMathTranslate-next: A fork with web-ui and additional features. This fork handles a large number of marginal cases, improves PDF compatibility, and optimizes cross-column and cross-page semantic consistency, dynamic scaling, and dynamic scaling consistency, among many other translation quality improvements. However, this fork is intended solely for development and does not address compatibility issues and is not designed for community-contributions.

5. Project Information

5.1 Citation

This work has been accepted by the Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing: System Demonstrations (EMNLP 2025).

Citation:

@inproceedings{ouyang-etal-2025-pdfmathtranslate,
	    title = "{PDFM}ath{T}ranslate: Scientific Document Translation Preserving Layouts",
	    author = "Ouyang, Rongxin  and
	      Chu, Chang  and
	      Xin, Zhikuang  and
	      Ma, Xiangyao",
	    editor = {Habernal, Ivan  and
	      Schulam, Peter  and
	      Tiedemann, J{\"o}rg},
	    booktitle = "Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing: System Demonstrations",
	    month = nov,
	    year = "2025",
	    address = "Suzhou, China",
	    publisher = "Association for Computational Linguistics",
	    url = "https://aclanthology.org/2025.emnlp-demos.71/",
	    pages = "918--924",
	    ISBN = "979-8-89176-334-0",
	    abstract = "Language barriers in scientific documents hinder the diffusion and development of science and technologies. However, prior efforts in translating such documents largely overlooked the information in layouts. To bridge the gap, we introduce PDFMathTranslate, the world{'}s first open-source software for translating scientific documents while preserving layouts. Leveraging the most recent advances in large language models and precise layout detection, we contribute to the community with key improvements in precision, flexibility, and efficiency. The work is open-sourced at https://github.com/byaidu/pdfmathtranslate with more than 222k downloads."
	}

5.2 Acknowledgement

• Immersive Translation sponsors monthly Pro membership redemption codes for active contributors to this project, see details at: CONTRIBUTOR_REWARD.md

• New backend: BabelDOC

• Document merging: PyMuPDF

• Document parsing: Pdfminer.six

• Document extraction: MinerU

• Document Preview: Gradio PDF

• Multi-threaded translation: MathTranslate

• Layout parsing: DocLayout-YOLO

• Document standard: PDF Explained, PDF Cheat Sheets

• Multilingual Font: Go Noto Universal

5.3 Contributors

For details on how to contribute, please consult the Contribution Guide.

5.4 Star History

Denzii 🕊️ (@denziideng): 我的妈呀！用完这家伙，再也回不去PPT动画了！免费开源还丝滑！🤙

PPT动画生硬卡顿？想做精准数学/知识讲解动画还得AE？👀

这款数学动画神器 Manim 就狠在这⬇

✅ 代码驱动精准：数学公式、图形变换精确到像素，丝滑流畅

✅ 完全免费开源：Python写动画，批量生成超高效

✅