项目工具栏与布局
从顶部栏为项目命名、编译、导出和安排布局。
项目工具栏位于工作区上方。打开一个练习文档,用本指南认出每个操作。编辑器内部的格式按钮分别在 LaTeX、Typst 和 Markdown 的文档中介绍。

选择左侧的主页可返回项目库。想继续工作时,从项目的书本图标或列表条目重新打开它。
项目名称
标题为“项目名称”的部分点击当前的项目名称即可编辑。输入一个有描述性的名称,然后按 Enter 或选择保存名称。按 Esc 或取消可保留原来的名称。项目名称用于在项目库中识别这项工作;重命名主源文件则是文件树里另外的操作。
源码视图
标题为“源码视图”的部分
选择源码视图,把主工作区交给文档编辑器。适合撰写长段落、编辑导言区,或查看完整的格式工具栏。
分屏视图
标题为“分屏视图”的部分选择分屏视图,让源码和预览并排显示。拖动分隔线可以调整两个窗格各占多少空间。调整表格、公式或图片时很有用。
PDF 视图
标题为“PDF 视图”的部分选择 PDF 视图,在主工作区中阅读编译输出。如果项目还没有预览,请先编译。用这种布局做完整的通读。
重新编译
标题为“重新编译”的部分
选择重新编译来构建当前项目。结果会显示在预览中,失败信息则出现在日志里。引擎决定源码如何变成 PDF。参见选择文档引擎和编译。
使用内置 Tectonic 引擎编译时,如果遇到它无法完成的事,按钮左侧会出现选择引擎。它会打开Tectonic 不够用时中介绍的引擎对话框。
编译选项
标题为“编译选项”的部分打开重新编译旁边的箭头,查看当前项目的编译选项。菜单只列出对该项目的引擎有实际作用的选项。
在 LaTeX 项目中,选择模板要求的编译器。想要内置的开箱即用方案,就用 Tectonic;需要传统 TeX 发行版时,就用 latexmk 编译器。提交之前,请让项目保持使用你测试过的编译器。
在 Typst 项目中,菜单里有自动编译(让 Typst 持续运行,并在你输入时刷新 PDF),还有 Typst 版本(本项目)、字体(本项目)、构建(本项目) 和变体(本项目)。安装其他 Typst 版本在设置 → 引擎 → Typst 中进行,Typst 能找到的字体列在文档设置里。编译解释了每个选项。
打开导出下载源码或编译结果。导出源码 (.zip) 会打包可编辑的项目文件;PDF 操作则保存可阅读的文档。转换类条目取决于引擎和文档类型。Word、HTML、文本、演示文稿和书籍的导出,请参考导出格式。
复刻项目
标题为“复刻项目”的部分选择复刻项目,基于当前项目创建另一个项目。输入一个说明用途的新名称,例如“论文,更短的摘要”。用这个副本尝试另一种方向,同时让原项目继续留在项目库中。
版本管理
标题为“版本管理”的部分打开版本管理,查看已保存的版本和恢复选项。已保存的检查点记录成功的构建;Git 历史记录由你控制的提交。请选择与想要恢复的内容相符的历史类型。

打开布局,从七种排列方式或禅模式中选择一种。布局决定显示哪些编辑器、预览和助手窗格,不会改变稿件。每种布局的图标会显示它打开三个窗格中的哪几个。
编辑器 + 预览 + AI
标题为“编辑器 + 预览 + AI”的部分同时显示源码、编译后的页面和助手。适合集中修改后立即编译。在较小的显示器上,请拓宽你正在使用的窗格,或选择双窗格布局。
编辑器 + 预览
标题为“编辑器 + 预览”的部分让源码和 PDF 并排显示。适合日常写作和版面调整。
编辑器 + AI
标题为“编辑器 + AI”的部分给源码和助手更多空间。适合讨论某一节、审阅建议的修改,或在重新打开 PDF 之前处理编译器错误。
预览 + AI
标题为“预览 + AI”的部分让渲染后的页面与助手并排显示。适合讨论尴尬的图片位置,或请支持页面图像的模型做一次视觉版面检查。
仅编辑器
标题为“仅编辑器”的部分把整个工作区用于编辑源码。这样可以同时显示更多工具栏控件,长行也更容易阅读。
仅预览
标题为“仅预览”的部分在更少干扰的情况下阅读成品文档。审阅时可以使用 PDF 搜索、文档大纲、页面导航和阅读视图。
仅 AI
标题为“仅 AI”的部分把工作区交给助手。适合做规划或进行较长的研究对话,之后再重新打开源码检查产出的工作成果。
禅模式
标题为“禅模式”的部分隐藏工具栏、侧边栏、助手和终端,只留下编辑器。再按一次同一个快捷键,或按两次 Esc,就能把它们调回来。禅模式介绍了快捷键、角落里的编译按钮和相关选项。
选择显示终端或按 Ctrl+`,显示项目的 shell。隐藏面板与关闭终端会话是两回事。标签页、命令和输出参见终端。
你可以在设置 → 键盘快捷键中更改它的按键,按钮的提示会显示当前的按键。
AI 助手
标题为“AI 助手”的部分选择显示 AI 助手,打开或隐藏助手窗格。助手的模型、批准、附件、提示词和对话控件,在聊天、计划与工具中介绍。
用外观在写作时切换界面主题。字体、颜色、PDF 默认值和终端样式,请打开外观设置。
选择齿轮图标,或按 ⌘,(Windows 和 Linux 上为 Ctrl+,),打开设置。设置目录把每个部分链接到它的控件和设置步骤。
编辑器工具栏上的文档工具
标题为“编辑器工具栏上的文档工具”的部分在项目工具栏下方,每个打开的文件都有自己的编辑器工具栏,对应 LaTeX、Typst 或 Markdown。文档工具位于它的右端:
- LaTeX 宏包或 Typst 包会搜索 CTAN 或 Typst Universe,并把包添加到文档中。参见宏包与包。
- 文档分析会列出文档中的图、表、公式、标签、引用和待办事项。参见文档分析。
- 文档设置可以更改纸张大小、页边距、字体、语言、行距和编号。参见文档设置。
撤销和重做位于该工具栏的起始位置附近,没有可撤销或重做的内容时呈灰色。其余部分在编辑器指南中介绍。
要全屏展示编译好的幻灯片,请使用预览工具栏上的放映。参见放映幻灯片。
在窄窗口中找到控件
标题为“在窄窗口中找到控件”的部分工具栏会根据可用宽度自适应。编辑器工具栏无论在什么宽度下,都会把放不下的按钮移入更多格式选项(…),所以不会有按钮消失。预览控件有自己的溢出菜单。如果某个控件好像不见了,请打开溢出菜单或拓宽窗格;更改文档的视图永远不会移除它的功能。