# 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 會留在你的電腦上；選擇之後，頁面會送到那個服務。
:::

只轉換你擁有或獲准重複使用的素材。重建的原始碼只是一份工作草稿，並不證明原始文件的結構或無障礙功能已被保留。