---
title: "Typst 和 AsciiDoc 转扫描版 PDF：不用装命令行工具和 Ruby，也不用上传"
description: "Look Scanned 现在可以直接打开 Typst 和 AsciiDoc 源文件了。选好 .typ 或 .adoc 文件，在预览里检查页面，再保存一份像从真正的扫描仪里出来的 PDF。"
date: 2026-10-08T05:00:00.000Z
lang: zh-CN
source: https://lookscanned.io/zh-CN/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-CN/scan/typst)，`.adoc` 和 `.asciidoc` 文件用 [AsciiDoc（.adoc）转扫描版 PDF](https://lookscanned.io/zh-CN/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-CN/scan/typst) 或 [AsciiDoc（.adoc）转扫描版 PDF](https://lookscanned.io/zh-CN/scan/asciidoc)，选择你的文件。
2. 稍等片刻，等页面准备好后逐页看一下预览，检查标题、公式、表格和代码。
3. 调整扫描效果。如果文档里有小字或者密集的公式，把模糊和噪点调低一些。
4. 点击“生成扫描件 PDF”，再点击“下载扫描件 PDF”。

如果需要图片，也可以把每一页导出成 JPG 或 PNG。具体怎么选，可以看看[扫描件的 PDF、JPG 和 PNG 格式区别](https://lookscanned.io/zh-CN/blog/scanned-document-pdf-jpg-png)。开通专业版后，用[批量扫描](https://lookscanned.io/zh-CN/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-CN/blog/latex-to-scanned-pdf)，以及 [Markdown、HTML 和 TXT 文件](https://lookscanned.io/zh-CN/blog/html-markdown-to-scanned-pdf)。

手上有需要做成扫描件的 `.typ` 或 `.adoc` 文件？[试试 Typst](https://lookscanned.io/zh-CN/scan/typst)，或者[试试 AsciiDoc](https://lookscanned.io/zh-CN/scan/asciidoc)。