---
title: "Typst 和 AsciiDoc 轉掃描檔 PDF：不用裝命令列工具和 Ruby，也不用上傳"
description: "Look Scanned 現在可以直接開啟 Typst 和 AsciiDoc 原始檔了。選好 .typ 或 .adoc 檔案，在預覽中確認頁面，再存成一份看起來像真的用掃描器掃出來的 PDF。"
date: 2026-10-08T05:00:00.000Z
lang: zh-HK
source: https://lookscanned.io/zh-HK/blog/typst-asciidoc-to-scanned-pdf
tags: ["Typst", "AsciiDoc", "PDF", "產品更新"]
---

# Typst 和 AsciiDoc 轉掃描檔 PDF：不用裝命令列工具和 Ruby，也不用上傳

不是每份文件都從 Word 開始。越來越多人用 Typst 寫論文、信件、履歷和上課講義，省去和 LaTeX 搏鬥的麻煩；也有很多團隊把手冊、規格文件和維運手冊寫成 AsciiDoc。可是一旦有人要一份簽好名的掃描檔，你眼前這台電腦上卻只有原始檔。

Look Scanned 現在兩種都能開。`.typ` 檔案請用 [Typst（.typ）轉掃描版 PDF](https://lookscanned.io/zh-TW/scan/typst)，`.adoc` 和 `.asciidoc` 檔案請用 [AsciiDoc（.adoc）轉掃描版 PDF](https://lookscanned.io/zh-TW/scan/asciidoc)。文件會在你的瀏覽器裡排成頁面，你在預覽中確認一遍，加上掃描效果，就能下載一份像真的經過掃描器的 PDF。不用安裝 Typst CLI，不用裝 Ruby 或 Asciidoctor PDF，也不必登入任何帳號。

## Typst：在瀏覽器裡執行的官方編譯器

Look Scanned 執行的是官方 Typst 編譯器（Typst 0.14）的瀏覽器版本，和 `typst compile` 背後是同一個編譯器。所以頁面、換行、公式和表格都會和你在自己電腦上編譯的一樣，文件裡設定的紙張大小和邊界也會保留。

- **第一次需要等一下**。編譯器和 Typst 的字型加起來大約 20 MB，第一次使用時會從 Look Scanned 下載。之後會從瀏覽器快取讀取，離線也能開啟 Typst 檔案。
- **只支援單一檔案，不支援套件**。只有自成一體的文件才能編譯。`#import "@preview/…"` 這類的行會失敗，因為沒有可以下載的套件庫。讀取其他檔案的寫法同樣不行：用 `#image` 放入的圖片、用 `#include` 引入的章節，以及從 CSV 或 JSON 檔案讀取的資料。
- **只有 Typst 的預設字型**。文字會用 Typst 內建的字型排版：Libertinus Serif、New Computer Modern 和它的數學字型，程式碼則用 DejaVu Sans Mono。電腦上安裝的字型無法使用，文件裡指定的其他字型會退回到這幾種。它們涵蓋拉丁字母（包括越南文）、希臘字母、西里爾字母和希伯來字母。中文、日文和韓文完全沒有可以退回的字型，阿拉伯文、泰文、天城文等文字也支援得不完善，所以如果文件用到這些文字，請在預覽中確認一下。
- **原始檔必須能編譯成功**。如果 Typst 回報錯誤，你看到的會是錯誤訊息，而不是頁面。

因為 Typst 在加上掃描效果之前會先產生一份真正的 PDF，它的文字也可以一起保留。存成 PDF 時，在「輸出設定」裡開啟「保留原文文字（類似 OCR）」，掃描檔 PDF 裡的文字就仍然可以搜尋和複製。

## AsciiDoc：不需要 Ruby 的 Asciidoctor

AsciiDoc 檔案由 Asciidoctor 轉換。Asciidoctor 是 AsciiDoc 的標準處理器，這裡用的是它在瀏覽器中執行的 JavaScript 版本。結果會排在邊界一英吋的 A4 紙上，能保留的內容有：

- 文件標頭：標題、作者和修訂資訊行；文件設定了 `:toc:` 時還有目錄。
- 章節、清單、表格、註腳、引文和程式碼標註。提示區塊（admonition）會以文字顯示標籤，例如 Note 或 Warning，而不是圖示。
- 文件設定了 `:stem:` 時，STEM 公式會用正式的數學字型排版。AsciiMath 和 LaTeX 兩種寫法都可以，行內和區塊都支援。
- 文件設定了 `:source-highlighter:` 時，程式碼區塊會依語法上色，不管它指定的是哪一個語法醒目提示工具。沒有這個屬性，程式碼區塊就維持單色，和在其他地方一樣。
- 很長的表格和程式碼區塊會接續到下一頁，表格的一列不會被切成兩半。

也有一些內容無法保留：

- **不會處理 `include::`**。每一條 include 指令都會顯示成指向其路徑的連結，而不是被引入的內容。請先把各部分合併成一個檔案。
- **圖片需要完整網址**。用 `images/diagram.png` 這類相對路徑引用的圖片會找不到，因為檔案是單獨開啟的，沒有它所在的資料夾。有完整 `https://` 網址的圖片會從存放它的網站載入，這需要連上網路。
- **圖表維持原始碼**。這裡沒有 Asciidoctor Diagram，所以 PlantUML 或 Mermaid 區塊會顯示成你輸入的文字。
- **字型來自你的裝置**。文字會用電腦或手機上安裝的字型排版，所以同一個檔案換一台裝置，分頁位置可能不同。
- **太長的檔案可能逾時**。排版必須在大約 30 秒內完成，所以像一本書那麼長的文件請拆成幾個小檔案。
- **不接受 `.asc` 檔案**。這個副檔名通常屬於 PGP 金鑰和簽章。開啟 AsciiDoc 檔案前，請先把它改名為 `.adoc`。

## 怎麼把 .typ 或 .adoc 檔案轉成掃描檔 PDF？

1. 開啟 [Typst（.typ）轉掃描版 PDF](https://lookscanned.io/zh-TW/scan/typst) 或 [AsciiDoc（.adoc）轉掃描版 PDF](https://lookscanned.io/zh-TW/scan/asciidoc)，選擇你的檔案。
2. 稍等一下，等頁面準備好之後逐頁看過預覽，確認標題、公式、表格和程式碼。
3. 調整掃描效果。如果文件裡有小字或密集的公式，把模糊和雜訊調低一點。
4. 點選「產生掃描檔 PDF」，再點選「下載掃描檔 PDF」。

如果需要圖片，也可以把每一頁匯出成 JPG 或 PNG。想了解怎麼選，請看[掃描檔的 PDF、JPG 和 PNG 格式比較](https://lookscanned.io/zh-HK/blog/scanned-document-pdf-jpg-png)。使用專業版的話，[批次掃描](https://lookscanned.io/zh-TW/scan/bulk)可以一次處理好幾個 `.typ` 或 `.adoc` 檔案。

## 檔案始終留在你的裝置上

兩種格式的轉換和掃描都在你的瀏覽器裡完成，原始檔不會上傳到伺服器。以 Typst 來說，唯一要下載的是編譯器和字型，來源是 Look Scanned 自己的網站；套件和其他檔案一律不會被抓取。以 AsciiDoc 來說，唯一的例外是有完整 `https://` 網址的圖片，它會從存放它的網站抓取，就和你用瀏覽器開啟那個頁面時一樣。

## 開始之前，先了解這幾點

- **產生的 PDF 是圖片**。和真正的掃描檔一樣，PDF 裡的文字無法選取或搜尋，除非你在 Typst 檔案上用了上面提到的文字選項。需要編輯時，請保留 `.typ` 或 `.adoc` 原始檔。
- **一定會加上掃描效果**。Look Scanned 的用途就是讓文件看起來像掃描檔。如果你只需要一份乾淨的 PDF，請直接用 Typst 或 Asciidoctor PDF 匯出。
- **需要套件、include 或圖表？** 在裝有 Typst 或 Asciidoctor PDF 的電腦上產生 PDF，再把這個 PDF 放進 Look Scanned 加上掃描效果。這個方法適用於任何文件，因為困難的部分原本的工具已經處理好了。

用的是其他格式嗎？看看 Look Scanned 怎麼處理 [LaTeX 檔案](https://lookscanned.io/zh-HK/blog/latex-to-scanned-pdf)，以及 [Markdown、HTML 和 TXT 檔案](https://lookscanned.io/zh-HK/blog/html-markdown-to-scanned-pdf)。

手邊有需要做成掃描檔的 `.typ` 或 `.adoc` 檔案嗎？[試試 Typst](https://lookscanned.io/zh-TW/scan/typst)，或是[試試 AsciiDoc](https://lookscanned.io/zh-TW/scan/asciidoc)。