帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
Typst 在线编辑器：多人在线协作写作
在线 Typst 编辑器，和合著者实时协作写作：边输入边在浏览器里编译 PDF，支持 Typst 包、文献引用和 AI 助手，无需安装。
新建 Typst 项目
JointTex 既是 LaTeX 的在线编辑器，也是 Typst 的在线编辑器：Typst 项目在浏览器里编写、编译和分享，无需安装任何东西。
操作步骤
- 打开「项目」，选择「新建项目」，在空白项目卡片上选 Typst。项目一开始就带有 main.typ 和一个 references.bib 文件，main.typ 已经用 #bibliography 指定了它。
- 也可以从 Typst 模板开始：模板是 LaTeX 还是 Typst 取决于它的根文件，用它创建的项目也按同样的方式编译。
- 把 Word 或 Markdown 草稿导入成 Typst：选择「新建项目」，再选「从文件导入」，选一个 .docx 或 .md 文件，并选择把它转换成 Typst。
- 一个项目可以同时包含两种语言。根文件决定用哪一种编译：根文件是 .typ 时由 Typst 编译，在项目设置里可以更改根文件。
边输入边看 PDF
Typst 就在编辑器页面里运行，停下输入片刻后 PDF 就会跟上，不用按编译按钮。
操作步骤
- Typst 项目从一开始就打开了「自动编译」。协作者的编辑也会让你的预览重新编译。
- 错误和警告会在源码里加下划线，并列在「问题」标签页里；在错误修好之前，上一次编译成功的 PDF 一直留在屏幕上。
- 在 PDF 里任意位置双击，或按住 Cmd/Ctrl 点击，即可跳到生成它的源码，按 {mod+j} 则从光标跳到 PDF。这些位置来自 Typst 编译器本身。
- 光标所在的公式会在你书写时显示为排版后的样子，「大纲」列出当前打开文件的各个标题。
- 在浏览器里，下载和打印会用同一版本的 Typst 在服务器上重新编译，所以你分享出去的就是项目自己的 PDF。
使用 Typst Universe 的包
发布在 Typst 包仓库里的包，用法和在其他地方一样。
操作步骤
- 用 #import "@preview/name:version" 导入包。某次编译第一次用到它时才会去获取。
- 服务器上的编译不联网，但仍然可以使用任何发布在 @preview 下的包。
- @local 命名空间里的包不可用，因为它们只存在于某个人的电脑上。请把包的文件放进项目，改用路径导入。
从 .bib 文件引用
Typst 读取和 LaTeX 相同的 .bib 文件：文档用 #bibliography 指定文件，用 @key 引用条目。
操作步骤
- 按 {mod+alt+c}，或点击工具栏上的「插入引用」(@)，搜索本项目、你的文献库、Crossref 等在线来源、Zotero，以及套餐支持的历史项目，插入 @key，同时把条目写进 .bib 文件。
- 在 @key 上，或在 .bib、.yml 文件中的键上按 F2 即可重命名：条目和所有引用都会随之更改。
- 要对照 Crossref 和 arXiv 核验你引用的条目，打开「项目检查」并选择「文献核验」。
多人协作写作
合著者可以同时编辑一个 Typst 项目，和 LaTeX 项目一样，每处改动都保留作者。
操作步骤
- 在「分享」对话框里邀请合著者；每个人都能实时看到其他人的光标和编辑。
- 选中一段文字并对它发表评论，在「审阅」里打开「跟踪我的编辑」让你的改动以建议形式出现，还可以从「历史」回到任何早先的版本。
- 用修订对比稿比较两个版本：typdiff 会在每个有改动的 .typ 文件里给新增内容加下划线、给删除内容加删除线。
向 AI 助手提问
助手知道项目是用 Typst 写的，会直接写 Typst。
操作步骤
- 打开 AI 面板，让它写一个表格、一张图、一条 show 规则，或修复一个编译错误。
- 「跟踪审阅」默认开启，开启时它做的每处编辑都会被标出，你可以逐条或一次性保留或放弃。
- 在「问题」标签页里，让它解释或修复某一个错误或全部错误；它会修改源码，并重新编译来检查修复结果。
在桌面应用里和离线工作
无论在浏览器里还是在桌面应用里，Typst 项目都不需要安装 TeX。
操作步骤
- 在桌面应用里，Typst 项目随着你的输入在应用窗口里编译，你保存或打印的 PDF 就是这同一份，不需要联网。
- 在浏览器里，打开过的项目会保留下来供离线使用，网络断开时也能继续写。
目前只在 LaTeX 文件里可用的功能
有几项工具读写的是 LaTeX 源码，在 .typ 文件里还不能用。
操作步骤
- 「格式化文档」和「复制为」只用于 .tex 文件。
- 符号网格插入的是 LaTeX 命令；图片按钮也支持 .typ 文件，会在插入前将识别结果转换成 Typst。
- 粘贴到 .typ 文件里的表格或图片不会被转换：表格会变成纯文本，图片不会被保存。