# 图片转 Typst

借助视觉模型（默认在本地），把图片中的笔记、公式或表格转录为可编辑的 Typst 源码。

图片转 Typst 把截图或照片变成可以修改、设置样式并编译的源码。对于白板上的笔记、拍下来的推导过程，或需要加入 Typst 文档的小表格，它是一个实用的起点。

## 何时有帮助

当图片中有你想编辑的内容时使用它。如果图片本身就是成品，请把它作为图放进项目。如果要得到完整的、可选中文字的 PDF，请改用 [PDF 转 Typst](/docs/tools/pdf-to-typst/)。

## 转录图片

1. 打开**图片转 Typst**，或运行 `/image-to-typst`。
2. 把 PNG、JPEG 或 WebP 图片拖入输入区域。
3. 选择**转换**。
4. 检查返回的 Typst 源码。
5. 复制它、保存 `transcription.typ`，或创建一个 Typst 项目。

该工具会请工具所用模型（除非你另选，否则是本地的 Ollama 模型）保留可见的文字、公式、表格和阅读顺序。它被要求不得编造缺失的文本，也不得悄悄改写行文。

## 检查结果

把源码及其编译后的预览与图片对照。请检查：

- 公式的分组、符号和上下限；
- 列或手写分支的顺序；
- 标题和列表的层级；
- 单位、标点和专有名称。

Typst 和 LaTeX 对某些结构的表达方式不同。如果最终目标是提交 LaTeX 稿件，请直接用[图片转 LaTeX](/docs/tools/image-to-latex/)转录，而不要再增加一步转换。

:::caution[需要视觉模型]
图片必须是 PNG、JPEG 或 WebP，并且小于 20 MB。你需要一个能够读图的模型。使用本地 Ollama 模型时，文件留在你的电脑上；使用托管模型或 Mathpix 时，文件会发送给那个服务。准确度仍取决于图片质量和所用的模型。
:::

该工具恢复的是可见的内容。它不会验证一次计算，也无法判断一个模糊的手写标记原本想表达什么。