编辑器工作区

打开 Markdown、LaTeX 或 Typst 项目后进入编辑器。默认布局从左到右是：侧栏（文件树和文件大纲）、源码编辑器、输出预览区。顶栏放项目标题和协作控件，底部状态栏显示连接与同步状态。

顶栏

• 项目标题旁的铅笔按钮 重命名项目（仅所有者）。
• 你的名称：显示给协作者看的名字，最多 24 个字符。
• 在线头像：最多显示 4 个，其余合并为“+N”。
• 版本历史、分享，见协作与版本。
• 更多操作 菜单：深色模式 / 浅色模式、下载当前文件、下载源码压缩包、用 Agent 更新、GitHub 集成、编辑器字号。

布局控制

侧栏

侧栏有 文件 和 评论 两个标签，评论标签显示未解决评论数。顶部按钮：新建文件、新建文件夹、上传文件、新建评论，以及 收起文件栏 / 展开文件栏（状态会记住）。

拖动侧栏右边缘可以调整宽度（220 到 480 像素），也可以用方向键微调，按住 Shift 步长更大；双击边缘恢复默认宽度。

文件大纲

文件树下方的 文件大纲 列出当前文件的标题层级：Markdown 的 # 标题、LaTeX 的 \part 到 \subsubsection、Typst 的 = 标题。点击标题跳转，光标所在章节会高亮；有子标题的章节可以用 ▾ / ▸ 收起或展开。点击面板标题可以整个折叠，拖动面板上边缘调整高度。

编辑器标签页

从文件树打开文件会新增一个标签。方向键在标签间切换，Delete 关闭当前聚焦的标签，最后一个标签不能关闭。同名文件的标签会显示完整路径。

编辑器与预览分栏

拖动中间分隔条调整比例（25% 到 75%），默认 60/40；方向键微调，Home / End 跳到两端，双击恢复默认。分隔条上的箭头 收起输出预览 / 展开输出预览 可以隐藏预览区，状态会记住。

专注写作

点击 专注写作 按钮或按 Ctrl/Cmd+Shift+F 进入专注模式：隐藏格式工具栏、行号、状态栏和顶栏的大部分控件，只保留编辑器、预览和 AI 面板。按 Esc 或点击右上角的 退出专注 返回。查看历史版本、二进制文件或独立 PDF 标签页时不可用。

全屏

进入全屏工作空间 使用浏览器全屏；浏览器不允许时退回页面内的全屏布局。

字号

• 编辑器字号：更多操作菜单中的 − / % / + 按钮，范围 70% 到 200%，步长 10%。快捷键 Ctrl/Cmd+Alt+= 放大、Ctrl/Cmd+Alt+- 缩小、Ctrl/Cmd+Alt+0 恢复。浏览器自身的 Ctrl/Cmd +/- 缩放不受影响。
• 预览字号（仅 Markdown 项目）：预览工具栏上的 缩小预览字号 / 放大预览字号，范围相同。

两项偏好各自保存在浏览器本地。

窄屏

宽度 720 像素以下时，侧栏变为可弹出的覆盖层，顶部出现 显示源码 / 显示输出预览 开关在编辑器和预览之间切换。手动编译会自动切到预览；点击大纲或评论会切回源码。

状态栏

显示连接状态（已连接 / 正在重新连接 / 离线）、同步状态（更改自动同步 / 离线模式）、更新时间、字符数和行数。编辑者的浏览器会保留一份离线副本，断网期间的修改会在重连后同步；查看者不保留副本。

文件管理

文件树菜单

每个文件或文件夹行有 “…” 菜单，也可以右键：设为主文件、重命名、下载（仅文件）、新建文件、新建文件夹、上传文件、删除。查看者只有“下载”。

新建

新建文件 和 新建文件夹 会弹出输入框。文件名可以带子目录，例如 sections/method.tex；不存在的目录会自动创建。新建的 .tex 文件以注释开头，.typ 文件同理。

文件名只允许 ASCII 字母、数字、_、.、/ 和 -。上传文件时其他字符（包括中文和空格）会被替换为 _。

重命名、移动、删除

• 重命名文件夹会一并更新其中所有文件的路径。主文件重命名时必须保留原扩展名。
• 拖动文件到文件夹上即可移动，拖到空白处移回根目录。只能拖动文件，主文件不能移动。
• 删除前会确认。主文件和包含主文件的文件夹不能删除。

上传

点击 上传文件，或把文件直接拖到文件树上（拖到某个文件夹行会上传到该文件夹），也可以拖到树下方的“拖拽文件到框内上传”区域。

• 同名文件存在时弹出 覆盖文件？ 对话框：单个文件可选 取消 / 覆盖，多个文件可对每个文件选 跳过 / 覆盖。
• 暂不支持上传整个文件夹，请选择文件。
• .tex、.bib、.md、.typ、.json、.csv、.py 等文本类扩展名上传后可以直接编辑；其他文件按二进制保存。
• 图片和 PDF 可以在编辑区预览并下载，其他二进制格式只能下载。

主文件

在 .md、.tex、.typ 文件上选 设为主文件。这同时会切换项目类型（例如从 LaTeX 切到 Typst）并重新编译或渲染。主文件在文件树中带有书签标记。

插入文件路径

把文本文件从文件树拖进编辑器，会在落点插入相对当前文件的路径，方便写 \input{}、\includegraphics{} 等。拖动图片文件目前不会插入内容。

下载

• 下载源码压缩包：整个项目打包为 source.zip。
• 下载当前文件：只下载当前打开的文件。
• 单个文件的 “…” 菜单也有 下载。

编辑功能

语法高亮与协作光标

按扩展名高亮 LaTeX、Markdown 和 Typst。协作者的光标带颜色和名字实时显示。查看者看到的是只读编辑器。

自动补全

输入时自动弹出，Tab 接受，Ctrl+Space 手动触发。

• LaTeX：常用命令（\section、\includegraphics、\begin、\frac、\usepackage 等）；\begin{ 后补全环境名；\ref、\eqref、\autoref 从项目中的 \label{} 补全；\cite、\citep、\citet、\parencite、\autocite 从 .bib 条目补全；\input、\include、\includegraphics、\bibliography、\addbibresource、\subfile、\lstinputlisting 中补全项目文件路径。
• Typst：#set、#show、#let、#figure、#image、#table 等，包括一个中文字体设置片段；@label 从 <label> 补全；#include、#image、#bibliography 等中补全路径。
• Markdown：行首块级片段、``` 后的代码语言（含 mermaid）、链接和图片中的路径。

折叠

行号槽中的三角形可以折叠代码块，折叠后显示“⋯ N 行”，点击展开。

• LaTeX：\begin…\end 环境（verbatim、lstlisting、minted、comment 的内容除外）和 \part 到 \subparagraph 章节，章节折叠到下一个同级或更高级章节为止。
• Markdown：按标题折叠。

格式工具栏

工具栏随当前文件类型变化：

• 通用：撤销、重做、在光标或所选文本处添加评论。
• Markdown：标题、粗体、斜体、删除线、引用块、无序列表、有序列表、任务列表、行内代码、代码块、插入链接、插入图片、插入表格、插入分割线。
• LaTeX：粗体、斜体、插入一级章节、插入二级章节、插入公式、插入无序列表、插入有序列表、插入引用。
• Typst：粗体、斜体、标题、插入子标题、插入无序列表、插入有序列表、插入数学公式、插入代码、插入链接。
• .bib 文件：检查引用，见AI 写作助手与引用检查。

快捷键

Markdown 文件额外支持：Ctrl/Cmd+B 粗体、Ctrl/Cmd+I 斜体、Ctrl/Cmd+Shift+X 删除线、Ctrl/Cmd+Alt+1 标题、Ctrl/Cmd+Alt+8 无序列表、Ctrl/Cmd+Alt+7 有序列表、Ctrl/Cmd+Alt+T 任务列表、Ctrl/Cmd+Alt+9 引用块、Ctrl/Cmd+Shift+C 行内代码、Ctrl/Cmd+Alt+C 代码块、Ctrl/Cmd+K 链接。按钮的悬停提示里也标注了这些快捷键。

限制

管理员可以在后台调低这些上限。