# LaTeX 转 Typst

把 LaTeX 草稿转为 Typst 源码，可以检查、保存，或作为新项目打开。

如果你想用 Typst 快速的本地工作流，而材料已经在 LaTeX 里，LaTeX 转 Typst 能让你领先一步。它会带上常见的文档结构和公式，把只有作者才能做的决定留给你。

## 适合这些情况

- 由标准章节、正文、列表、链接、表格和公式构成的文章或笔记；
- 测试现有草稿是否适合改用 Typst；
- 不必重新输入就能迁移内容。

如果工作依赖出版商文档类、大量的宏，或没有 Typst 对应物的宏包，请留在 LaTeX。转换无法让期刊接受另一种源码格式。

## 转换源码

1. 打开 **LaTeX 转 Typst**，或运行 `/latex-to-typst`。
2. 粘贴 LaTeX 源码。
3. 选择 **转换**。
4. 阅读生成的 Typst，并检查其中的转换说明。
5. 复制它，保存 `converted.typ`，或创建 Typst 项目并编译。

标准的 `\section`、段落、无序列表和行间公式会对应到各自的 Typst 写法。而像 `\newcommand{\model}{...}` 这样的自定义命令，可能需要你手动改成 Typst 函数或变量。

## 检查迁移结果

内置的 Pandoc 转换在本地运行，并对生成的 Typst 做兼容性清理。它不会还原 LaTeX 宏包的行为，也不会还原文档类的视觉规则。

请检查：

- 自定义宏和环境；
- 公式语法和编号；
- 图片路径和图注；
- 表格和交叉引用；
- 参考文献和引用样式；
- 页面几何设置和字体排印。

在 Typst 版本编译通过、并且完整的 PDF 已经比对之前，请保留原始项目。如果需要反向转换，请使用 [Typst 转 LaTeX](/docs/tools/typst-to-latex/)。

## 转换整个项目

这个工具转换的是你粘贴的文本。如果 LaTeX 项目包含多个文件、图片和参考文献，请打开该项目，并在命令面板中运行 **转换为 Typst 项目**。它会创建一个独立的 Typst 项目，编译它，并报告哪些地方需要处理。[Typst 项目](/docs/typst/#convert-a-latex-project-to-typst)中有完整的操作流程。如果只是转换单个公式，[公式转 Typst](/docs/tools/equation-to-typst/) 更快。