Chuyển đến nội dung

PDFMathTranslate / PDFMathTranslate

PDFMathTranslate (pdf2zh)

Dịch PDF khoa học sang ngôn ngữ khác mà vẫn giữ công thức, biểu đồ, mục lục và bố cục

PDFMathTranslate (lệnh pdf2zh) dịch cả file PDF, nhất là bài báo khoa học nhiều công thức, và xuất ra bản dịch giữ nguyên bố cục, kèm bản song ngữ. Dùng được qua dòng lệnh, giao diện web chạy trên máy, Docker, bản Windows đóng gói sẵn hoặc plugin Zotero. Phiên bản 2.0 đã chuyển sang kho PDFMathTranslate-next.

  • 38.457 sao
  • 3.451 fork
  • Python
  • Cập nhật hôm nay
  • AGPL 3.0 (chạy dịch vụ cũng phải công bố mã)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI), Web tự cài (self-host)
Chạy trên
Windows, macOS, Linux, Docker, Python
Chi phí
Miễn phí (trả phí API AI nếu dùng)

Trải nghiệm khi dùng PDFMathTranslate (pdf2zh)

Bạn cài bằng pip hoặc uv, rồi gõ pdf2zh kèm tên file PDF. Chương trình tải mô hình nhận diện bố cục ở lần đầu, sau đó dịch và tạo hai file trong thư mục hiện tại: một bản chỉ có ngôn ngữ đích và một bản song ngữ để đối chiếu từng đoạn. Công thức, hình vẽ, bảng và mục lục giữ nguyên chỗ cũ thay vì bị phá như khi dán văn bản vào trình dịch.

Nếu không thích gõ lệnh, chạy pdf2zh -i để mở giao diện web ở máy bạn, hoặc dùng bản Windows đóng gói sẵn: tải file zip ở trang Releases, giải nén và bấm đúp pdf2zh.exe. Người dùng phần mềm Zotero có thể dùng plugin Zotero PDF2zh để dịch ngay trong thư viện tài liệu. Ngoài ra README có liệt kê vài dịch vụ thử miễn phí trên mạng, không cần cài đặt, nhưng tài nguyên có hạn.

Mặc định chương trình dùng Google làm dịch vụ dịch, tức là nội dung PDF được gửi tới dịch vụ bên ngoài. Bạn có thể chọn dịch vụ khác bằng tuỳ chọn -s, trong đó nhiều dịch vụ cần khoá API riêng.

Tính năng nổi bật

Giữ công thức và bố cục

Bảo toàn công thức, biểu đồ, mục lục và chú thích khi dịch.

Hai bản kết quả

Xuất bản dịch thuần và bản song ngữ để đọc đối chiếu.

Nhiều cách dùng

Dòng lệnh, giao diện web cục bộ (pdf2zh -i), Docker, bản Windows đóng gói sẵn và plugin Zotero.

Nhiều dịch vụ dịch

Chọn dịch vụ bằng -s, ví dụ deepl, hoặc nối với mô hình AI qua khoá API; danh sách đầy đủ có trong tài liệu.

Dịch một phần tài liệu

Dùng -p để chỉ dịch các trang cần thiết, tiết kiệm thời gian và chi phí.

Chế độ nhanh và OCR thử nghiệm

Có chế độ --ultrafast cho PDF có chữ sẵn và hỗ trợ OCR thử nghiệm cho trang scan dạng ảnh (cài thêm gói tuỳ chọn).

Tận dụng PDFMathTranslate (pdf2zh) vào việc gì?

Sinh viên, nghiên cứu sinh

Đọc bài báo khoa học tiếng Anh

Dịch bài báo nhiều công thức sang tiếng mẹ đẻ để nắm ý nhanh, rồi đối chiếu với bản gốc khi cần chính xác.

Kỹ sư, nhân viên kỹ thuật

Dịch tài liệu kỹ thuật, hướng dẫn thiết bị

Dịch catalog, datasheet, sách hướng dẫn mà vẫn giữ sơ đồ và bảng thông số đúng chỗ.

Giảng viên, sinh viên

Dịch giáo trình để học nhóm

Tạo bản song ngữ cho từng chương giúp học thuật ngữ chuyên ngành.

Người dùng Zotero

Tích hợp vào quy trình đọc paper

Cài plugin để dịch ngay từ thư viện tài liệu mà không phải mở thêm công cụ khác.

Cần chuẩn bị gì?

  • Python 3.11 đến 3.12 nếu cài bằng pip hoặc uv.
  • Lần đầu cần Internet để tải mô hình nhận diện bố cục; một số khu vực có thể gặp khó, README có hướng dẫn dùng biến HF_ENDPOINT làm cách khắc phục.
  • Windows bản đóng gói có thể cần cài thêm gói Visual C++ Redistributable (vc_redist.x64.exe) nếu không mở được file.
  • Khoá API nếu dùng dịch vụ dịch hoặc mô hình AI có tính phí.

Hướng dẫn cài đặt chi tiết

Cài trên Windows (bản đóng gói)

  1. Vào trang Releases của kho mã và tải file pdf2zh-<phiên bản>-win64.zip (README nêu cách làm này).

  2. Giải nén rồi bấm đúp pdf2zh.exe để chạy. Nếu không mở được, cài vc_redist.x64.exe của Microsoft rồi thử lại.

  3. Lưu ý README cho biết phiên bản 2.0 đã chuyển sang kho PDFMathTranslate-next, nên bản mới nhất có thể nằm ở đó.

Cài trên Python (uv hoặc pip)

  1. Cách khuyến nghị trong README: cài Python 3.11 hoặc 3.12, sau đó cài công cụ bằng uv.

    Terminal
    pip install uv
    uv tool install --python 3.12 pdf2zh
  2. Hoặc cài thẳng bằng pip trong môi trường ảo.

    Terminal
    pip install pdf2zh
  3. Chạy dịch một file; kết quả nằm trong thư mục hiện tại.

    Terminal
    pdf2zh document.pdf

Cài trên Giao diện web / Docker

  1. Giao diện web ngay trên máy: cài bằng pip rồi chạy lệnh dưới, nếu trình duyệt không tự mở thì vào địa chỉ http://localhost:7860/.

    Terminal
    pdf2zh -i
  2. Hoặc dùng Docker: kéo ảnh và chạy, rồi mở http://localhost:7860/ trong trình duyệt.

    Terminal
    docker pull byaidu/pdf2zh
    docker run -d -p 7860:7860 byaidu/pdf2zh
  3. Không vào được Docker Hub thì README gợi ý dùng ảnh trên GitHub Container Registry (ghcr.io/byaidu/pdfmathtranslate).

Dùng thử lần đầu

  1. Chọn một bài báo PDF ngắn (vài trang) và đặt vào thư mục làm việc.

  2. Chạy dịch. Tuỳ chọn -li là ngôn ngữ gốc, -lo là ngôn ngữ đích; hãy kiểm tra mã ngôn ngữ tiếng Việt có được hỗ trợ trong danh sách ngôn ngữ của tài liệu rồi thay vào.

    Terminal
    pdf2zh document.pdf -li en -lo MA_NGON_NGU_DICH
  3. Mở hai file kết quả (...-mono.pdf và ...-dual.pdf) để so sánh bản dịch thuần với bản song ngữ.

  4. Thử dịch một phần tài liệu để tiết kiệm thời gian, ví dụ chỉ trang 1.

    Terminal
    pdf2zh document.pdf -p 1
  5. Muốn đổi dịch vụ dịch, thêm -s kèm tên dịch vụ (ví dụ deepl, cần khoá API riêng thiết lập theo tài liệu).

    Terminal
    pdf2zh document.pdf -s deepl

Mẹo dùng hay

  • Thử trên vài trang trước rồi mới dịch cả file dài, vì tài liệu nhiều công thức dễ gặp lỗi bố cục.
  • Dùng --ultrafast cho PDF đã có sẵn chữ để dịch nhanh, nhưng với bảng và công thức phức tạp thì nên dùng chế độ thường.
  • Nếu cần dịch bằng mô hình riêng hoặc theo văn phong riêng, xem tuỳ chọn --prompt trong tài liệu.

Lưu ý và hạn chế

  • Mặc định dùng Google để dịch, nghĩa là nội dung được gửi ra ngoài; đừng dùng với tài liệu mật nếu chưa đổi sang dịch vụ phù hợp.
  • Chỉ dịch tài liệu bạn có quyền dùng; việc dịch rồi phân phối lại sách hoặc bài báo có bản quyền có thể vi phạm điều khoản.
  • Giấy phép AGPL-3.0 có yêu cầu riêng nếu bạn đưa phần mềm lên thành dịch vụ cho người khác; kiểm tra điều khoản trước khi thương mại hoá.

Câu hỏi thường gặp

Có dịch sang tiếng Việt được không?

Công cụ hỗ trợ nhiều ngôn ngữ và nhiều dịch vụ dịch; hãy kiểm tra danh sách ngôn ngữ trong tài liệu để chắc chắn tiếng Việt có trong dịch vụ bạn chọn. Chất lượng tuỳ dịch vụ.

Có miễn phí không?

Phần mềm miễn phí, mã nguồn mở. Dịch vụ dịch mặc định miễn phí, còn các dịch vụ hay mô hình AI khác có thể tính phí theo khoá API của bạn.

Có an toàn cho tài liệu riêng tư không?

Phần mềm chạy trên máy bạn, nhưng nội dung vẫn được gửi tới dịch vụ dịch bạn chọn (mặc định là Google), nên tài liệu nhạy cảm cần cân nhắc.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/PDFMathTranslate/PDFMathTranslate.git

Repo tương tự nên xem

Tài liệu, OCR & hỏi đáp tri thức96,8K

Stirling PDF

Stirling-Tools / Stirling-PDF

Bộ hơn 50 công cụ PDF: gộp, tách, ký, che thông tin, nén, OCR, chạy trên máy hoặc tự cài.

DễWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức40,9K

Marker

datalab-to / marker

Chuyển PDF, ảnh, Word, PowerPoint thành Markdown, JSON hoặc HTML giữ nguyên bảng biểu và công thức

VừaWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức35,3K

OCRmyPDF

ocrmypdf / OCRmyPDF

Biến PDF scan thành PDF có lớp chữ, tìm kiếm và sao chép được, chỉ với một lệnh

VừaWindowsmacOSLinuxDocker+1

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tài liệu, OCR & hỏi đáp tri thức

Tài liệu, OCR & hỏi đáp tri thức196K

MarkItDown

microsoft / markitdown

Công cụ của Microsoft đổi PDF, Word, Excel, PowerPoint và nhiều file khác thành Markdown cho AI đọc.

VừaWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức94,2K

RAGFlow

infiniflow / ragflow

Nền tảng tự cài giúp AI trả lời dựa trên tài liệu của bạn, có trích dẫn nguồn.

VừaDockerLinuxWeb
Tài liệu, OCR & hỏi đáp tri thức92,7K

PaddleOCR

PaddlePaddle / PaddleOCR

Bộ công cụ OCR của Baidu: đọc chữ trong ảnh, PDF và đổi tài liệu thành Markdown hoặc JSON.

KhóWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức83,7K

MinerU

opendatalab / MinerU

Đọc PDF, ảnh scan và file Office rồi xuất Markdown, giữ bảng, công thức và bố cục phức tạp.

VừaWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức77,5K

Tesseract OCR

tesseract-ocr / tesseract

Bộ máy nhận dạng chữ (OCR) mã nguồn mở đọc chữ từ ảnh scan, hỗ trợ hơn 100 ngôn ngữ

VừaWindowsmacOSLinux
Tài liệu, OCR & hỏi đáp tri thức70,6K

Docling

docling-project / docling

Chuyển PDF, Word, PowerPoint, Excel, HTML thành Markdown hoặc JSON gọn gàng để đưa cho AI đọc

VừaWindowsmacOSLinuxPython

Xem cả 22 repo Tài liệu, OCR & hỏi đáp tri thức Về Kho Repo