# 可视化 Typst 编辑器

直接在分屏的写作与预览布局中开始 Typst 项目。

可视化 Typst 编辑器省去了新建空白项目的设置步骤。它会创建一个 Typst 文档，并把源码与实时 PDF 预览并排打开，从第一行起就能看到每次修改的效果。

## 何时选择这个工具

当你在学习 Typst、把一个小想法变成排版好的文档，或希望同时看到源码和输出时，请使用它。

如果屏幕空间紧张，或者你更喜欢从仅编辑器的布局开始，请选择 [Typst 编辑器](/docs/tools/typst-editor/)。两个工具创建的是同一种项目，只是打开时的布局不同。

:::note[这里的“可视化”是什么意思]
这个工具打开的是源码与预览分屏的工作区。如果想在隐藏标记的情况下编辑，请在任何 Typst 文件中把编辑器工具栏从 **代码** 切换到 **可视化**。标题、强调、列表、公式、图片、表格和引用会就地渲染，光标所在的行会显示源码。
:::

## 开始文档

1. 打开 **设置 → 实验功能 → LaTeX 工具**。
2. 打开 **可视化 Typst 编辑器**，或运行 `/visual-typst-editor`。
3. Oleafly 会创建 **无标题 Typst 文档**，并以分屏视图打开。
4. 重命名项目，然后在 `.typ` 源文件中书写。
5. 预览准备好后，导出编译好的 PDF。

先试试这个小小的开头：

```typst
= Results

The treatment group improved by *12%*.

$ integral_0^1 x^2 dif x = 1/3 $
```

开启 **自动编译** 后，内置的 Typst 引擎会在你输入时刷新预览。你的源码仍是普通的 `.typ` 文件，可以在 Oleafly 之外编辑。

## 须知

- Typst 编译和 PDF 导出都在本地运行。
- Typst 使用来自 Typst Universe 的包，而不是 LaTeX 宏包或 `tlmgr`。
- LaTeX 命令不能直接转换为 Typst 语法。如需得到转换后的起点，请使用 [LaTeX 转 Typst](/docs/tools/latex-to-typst/)。
- **跳转到 PDF** 以及在 PDF 中点击，都能在源码和页面之间跳转，与 LaTeX 项目中一样。

项目创建之后，关于项目编辑、文件和导出，请继续阅读[用 Typst 写作](/docs/writing/typst/)。[Typst 项目](/docs/typst/)介绍了版本、包和字体。