# PDF 转 Typst

从 PDF 中恢复可编辑的 Typst 源码和图片，扫描页面则用视觉模型转写。

PDF 转 Typst 为一份固定的文档开启可编辑的下一章。它会恢复文字和有用的结构，然后写出 Typst 源码，你可以在本地简化、重新设计样式并编译。

## 适用场景

- 你要把自己的 PDF 迁移到 Typst 工作流；
- 原始源码已经找不到；
- 恢复内容比匹配每个像素更重要。

如果作者发布了原始源码压缩包，请改用那个。如果目标是 LaTeX 文档类或投稿，请选择 [PDF 转 LaTeX](/docs/tools/pdf-to-latex/)；如果只是想得到纯文本笔记，请选择 [PDF 转 Markdown](/docs/tools/pdf-to-markdown/)。

## 转换文档

1. 打开 **PDF 转 Typst**，或运行 `/pdf-to-typst`。
2. 选择不超过 128 MB 的 PDF。
3. 开始转换。
4. 检查 Typst 源码和提取出的文件。
5. 复制它，保存 `converted.typ`，或创建 Typst 项目并编译。

可选中文字的 PDF 会走 Oleafly 的本地文字层流程。它会重建阅读顺序，找出疑似的标题和公式，提取图片，然后把恢复出的结构转换为 Typst。疑似扫描件可以用工具所用模型（除非你另选，否则是本地的 Ollama 模型）逐页转写。

## 检查新源码

请先看多栏阅读顺序、脚注、公式符号、表格单元格、图注和参考文献。然后选择一个 Typst 模板，再有意识地重建页面级的设计。

:::note[扫描页面]
视觉转写限制在 50 页以内，并且需要能读取图片的模型。文字层转换不需要 AI 模型。除非你为扫描件选择托管模型或 Mathpix，否则 PDF 会留在你的电脑上；选了之后，页面会发送给那个服务。
:::

只转换你拥有或获许复用的材料。重建出的源码只是工作草稿，并不能证明原文档的结构或无障碍性得到了保留。