--- title: "Chuyển Typst và AsciiDoc sang PDF bản quét: không cần CLI, Ruby hay tải lên" description: "Look Scanned giờ đã mở được tệp nguồn Typst và AsciiDoc. Chọn tệp .typ hoặc .adoc, kiểm tra các trang trong bản xem trước rồi lưu thành PDF trông như vừa ra khỏi máy quét thật." date: 2026-10-08T05:00:00.000Z lang: vi source: https://lookscanned.io/vi/blog/typst-asciidoc-to-scanned-pdf tags: ["Typst", "AsciiDoc", "PDF", "cập nhật sản phẩm"] --- # Chuyển Typst và AsciiDoc sang PDF bản quét: không cần CLI, Ruby hay tải lên Không phải tài liệu nào cũng bắt đầu từ Word. Typst đã trở thành cách nhanh để viết bài báo, thư từ, CV và ghi chú bài giảng mà không phải vật lộn với LaTeX, còn nhiều nhóm lưu sổ tay, đặc tả và quy trình vận hành của mình bằng AsciiDoc. Rồi có người cần một bản sao đã ký và quét, trong khi máy tính trước mặt bạn chỉ có tệp nguồn. Look Scanned giờ đã mở được cả hai. Dùng [Typst (.typ) sang PDF bản quét](https://lookscanned.io/vi/scan/typst) cho tệp `.typ` và [AsciiDoc (.adoc) sang PDF bản quét](https://lookscanned.io/vi/scan/asciidoc) cho tệp `.adoc` và `.asciidoc`. Tài liệu được dàn thành trang ngay trong trình duyệt của bạn. Bạn kiểm tra trong bản xem trước, thêm hiệu ứng quét và tải xuống một PDF trông như vừa đi qua máy quét thật. Không cần cài Typst CLI, Ruby hay Asciidoctor PDF, cũng không cần đăng nhập tài khoản nào. ## Typst: trình biên dịch thật, ngay trong trình duyệt Look Scanned chạy trình biên dịch Typst chính thức (Typst 0.14) trong một phiên bản dành cho trình duyệt. Đây cũng là trình biên dịch đứng sau `typst compile`, nên trang, ngắt dòng, công thức và bảng ra giống hệt như trên máy của bạn, kể cả khổ giấy và lề mà tài liệu đặt. - **Lần đầu cần đợi một chút.** Trình biên dịch và phông chữ của Typst, tổng cộng khoảng 20 MB, được tải từ Look Scanned vào lần đầu. Sau đó chúng được lấy từ bộ nhớ đệm của trình duyệt, và tệp Typst mở được cả khi ngoại tuyến. - **Một tệp, không gói.** Chỉ những tài liệu tự đủ trong một tệp mới biên dịch được. Dòng `#import "@preview/…"` sẽ lỗi vì không có kho gói nào để tải về. Mọi thứ đọc từ tệp khác cũng vậy: ảnh chèn bằng `#image`, chương đưa vào bằng `#include`, hay dữ liệu đọc từ tệp CSV hoặc JSON. - **Chỉ có phông mặc định của Typst.** Văn bản được dàn bằng các phông đi kèm Typst: Libertinus Serif, New Computer Modern cùng phông toán của nó, và DejaVu Sans Mono cho mã. Phông đã cài trên máy tính không dùng được, nên phông khác mà tài liệu chỉ định sẽ được thay bằng các phông này. Chúng hỗ trợ chữ Latinh (kể cả tiếng Việt), Hy Lạp, Kirin và Do Thái. Văn bản tiếng Trung, tiếng Nhật và tiếng Hàn không có phông nào để thay thế, còn các hệ chữ như Ả Rập, Thái hay Devanagari cũng không được hỗ trợ đầy đủ, nên hãy kiểm tra bản xem trước nếu tài liệu của bạn có dùng chúng. - **Mã nguồn phải biên dịch được.** Nếu Typst báo lỗi, bạn sẽ thấy thông báo lỗi thay vì các trang. Vì Typst tạo ra một PDF thật trước khi hiệu ứng quét được thêm vào, văn bản của nó có thể được giữ lại. Khi lưu thành PDF, hãy bật “Giữ văn bản gốc (tương tự OCR)” trong Cài đặt đầu ra, và văn bản trong PDF bản quét vẫn tìm kiếm và sao chép được. ## AsciiDoc: Asciidoctor không cần Ruby Tệp AsciiDoc được chuyển đổi bằng Asciidoctor, bộ xử lý chuẩn của AsciiDoc, trong phiên bản JavaScript chạy ngay trong trình duyệt. Kết quả được dàn trên trang A4 với lề một inch, và những gì được giữ lại gồm: - Phần đầu tài liệu: tiêu đề, tác giả và dòng phiên bản, cùng mục lục khi tài liệu đặt `:toc:`. - Mục, danh sách, bảng, chú thích cuối trang, trích dẫn và chú thích trong mã (callouts). Các khối lưu ý (admonitions) hiển thị nhãn, như Note hay Warning, bằng chữ thay vì biểu tượng. - Công thức STEM, được dàn bằng một phông toán đúng nghĩa khi tài liệu đặt `:stem:`. Cả ký pháp AsciiMath lẫn LaTeX đều dùng được, trong dòng lẫn thành khối riêng. - Đoạn mã được tô màu theo cú pháp khi tài liệu đặt `:source-highlighter:`, bất kể nó chỉ định bộ tô sáng nào. Không có thuộc tính đó, đoạn mã vẫn để trơn, như ở bất kỳ đâu khác. - Bảng và đoạn mã dài tiếp tục sang trang sau, và một hàng trong bảng không bao giờ bị cắt đôi. Một số thứ không được giữ lại: - **`include::` không được thực hiện.** Mỗi chỉ thị include hiện thành một liên kết tới đường dẫn của nó thay vì nội dung được đưa vào. Hãy gộp các phần lại thành một tệp trước. - **Ảnh cần địa chỉ web đầy đủ.** Ảnh được tham chiếu bằng đường dẫn tương đối như `images/diagram.png` sẽ không tìm thấy, vì tệp được mở riêng lẻ, không kèm thư mục của nó. Ảnh có địa chỉ `https://` đầy đủ được tải từ trang web lưu trữ nó, nên cần có kết nối internet. - **Sơ đồ vẫn ở dạng mã nguồn.** Asciidoctor Diagram không có sẵn, nên khối PlantUML hay Mermaid hiện ra đúng như văn bản bạn đã gõ. - **Phông chữ lấy từ thiết bị của bạn.** Văn bản được dàn bằng các phông đã cài trên máy tính hoặc điện thoại, nên cùng một tệp có thể ngắt trang ở chỗ khác trên một thiết bị khác. - **Tệp quá dài có thể hết thời gian.** Việc dàn trang phải xong trong khoảng 30 giây, vì vậy hãy chia một tài liệu dài cỡ một cuốn sách thành các tệp nhỏ hơn. - **Không nhận tệp `.asc`.** Phần mở rộng này thường dùng cho khóa và chữ ký PGP. Hãy đổi tên tệp AsciiDoc thành `.adoc` trước khi mở. ## Cách biến tệp .typ hoặc .adoc thành PDF bản quét 1. Mở [Typst (.typ) sang PDF bản quét](https://lookscanned.io/vi/scan/typst) hoặc [AsciiDoc (.adoc) sang PDF bản quét](https://lookscanned.io/vi/scan/asciidoc) và chọn tệp của bạn. 2. Đợi một lát trong lúc các trang được chuẩn bị, rồi xem bản xem trước từng trang một. Kiểm tra tiêu đề, công thức, bảng và mã. 3. Điều chỉnh hiệu ứng quét. Hãy để độ mờ và nhiễu ở mức thấp nếu tài liệu có chữ nhỏ hoặc công thức dày đặc. 4. Nhấn “Tạo PDF đã quét”, sau đó nhấn “Tải xuống PDF đã quét”. Nếu muốn dùng ảnh, bạn có thể xuất mỗi trang thành JPG hoặc PNG. [Hướng dẫn chọn PDF, JPG và PNG](https://lookscanned.io/vi/blog/scanned-document-pdf-jpg-png) của chúng tôi giải thích khi nào nên dùng định dạng nào. Nếu dùng Pro, [Quét hàng loạt](https://lookscanned.io/vi/scan/bulk) xử lý được nhiều tệp `.typ` hoặc `.adoc` cùng lúc. ## Tệp của bạn ở lại trên thiết bị của bạn Cả hai định dạng đều được chuyển đổi và quét trong trình duyệt, và tệp nguồn không bao giờ bị tải lên máy chủ. Với Typst, thứ duy nhất được tải về là trình biên dịch và phông chữ, từ chính trang web của Look Scanned; gói và tệp khác không bao giờ được tải. Với AsciiDoc, ngoại lệ duy nhất là ảnh có địa chỉ `https://` đầy đủ, được tải từ trang web lưu trữ nó, giống như khi bạn mở trang đó trong trình duyệt. ## Điều nên biết - **Kết quả được tạo từ hình ảnh.** Giống một bản quét thật, văn bản trong PDF không chọn hay tìm kiếm được, trừ khi bạn đã dùng tùy chọn văn bản ở trên cho tệp Typst. Hãy giữ tệp nguồn `.typ` hoặc `.adoc` để chỉnh sửa. - **Hiệu ứng quét luôn được áp dụng.** Look Scanned dùng để làm tài liệu trông như bản quét. Nếu bạn chỉ cần một PDF sạch, hãy xuất bằng Typst hoặc Asciidoctor PDF. - **Cần gói, include hay sơ đồ?** Hãy tạo PDF trên một máy đã cài Typst hoặc Asciidoctor PDF, rồi thêm hiệu ứng quét cho PDF đó trong Look Scanned. Cách này dùng được với mọi tài liệu, vì phần khó nhất công cụ gốc đã làm xong. Bạn viết bằng định dạng khác? Xem Look Scanned xử lý [tệp LaTeX](https://lookscanned.io/vi/blog/latex-to-scanned-pdf) và [tệp Markdown, HTML và TXT](https://lookscanned.io/vi/blog/html-markdown-to-scanned-pdf) như thế nào. Bạn có tệp `.typ` hoặc `.adoc` cần trông như bản quét? [Thử với Typst](https://lookscanned.io/vi/scan/typst) hoặc [với AsciiDoc](https://lookscanned.io/vi/scan/asciidoc).