文档与浏览器标签页
中栏的标签页不只有终端。本章介绍另外两类标签页:文档标签页(内置的 Markdown 与代码编辑器)和浏览器标签页(内嵌网页)。它们与会话标签页共用标签栏,打开会话时不会替换它们。
1. 文档标签页
1.1 打开方式
以下操作会打开文档标签页:
- 在任意会话中运行
vopen <file>(在「设置 ▸ 通用」中安装「Vela 技能」后,Claude Code 中的/vopen技能也能实现同样的效果); - 在右栏的「文件」标签页中双击文件,或选择「在编辑器中打开」;
- 在知识库中打开笔记(见本地知识库);
- 点击标签栏右端的「新建文档」。
打开的视图取决于文件类型:
| 类型 | 视图 |
|---|---|
| md / markdown / mdx | Markdown 编辑器,提供「所见即所得」「源码模式」和「对照模式」;默认以所见即所得模式打开 |
| 图片(png、jpg、jpeg、gif、webp、svg、bmp、ico、avif) | 图片查看器,提供「适应窗口」和「1:1」 |
| 其他文件 | 代码编辑器,根据文件名选择语法高亮 |

1.2 Markdown 编辑器
- 所见即所得模式下,编辑时看到的就是最终显示的效果。输入
/可打开插入菜单(标题、列表、任务列表、引用、代码块、表格、数学公式、图片和分割线)。用围栏标记的mermaid代码块会在代码块下方渲染为图表。 - 源码模式按文件实际存储的内容显示文本(包括 YAML front matter),并提供 Markdown 语法高亮。
- 对照模式将所见即所得和源码并排显示,编辑任意一侧时,两侧都会保持同步。
- ⌘/(Windows 和 Linux 上为 Ctrl+/)可在所见即所得和源码模式之间切换。仅切换模式而不编辑,不会改动文件。
- 将图片粘贴或拖入已保存的文档时,图片会存放到文档旁的
assets文件夹中,并插入指向它的相对链接。
1.3 编辑与保存
- 按 ⌘S 或点击「保存」按钮即可将文件写入磁盘。标签页上的圆点表示有未保存的修改。
- 当前文档每两秒检查一次磁盘。如果其他程序修改了该文件,会出现一个横幅,提供「重新加载」和「忽略」;如果你同时也有未保存的编辑,重新加载按钮会显示为「重新加载(丢弃我的修改)」。如果在你开始编辑后磁盘上的文件发生了变化,保存时会先弹出「保存冲突」对话框请你确认,然后才会覆盖文件。
- 关闭有未保存修改的标签页时,会要求你选择「保存并关闭」「不保存关闭」或「取消」。
- ⌘F 会打开搜索栏,提供查找、替换、全部替换和「区分大小写」;在各种模式下用法相同。
- 「侧栏」按钮会显示文档的「大纲」及其所在文件夹的「目录树」;点击其中的文件即可打开。侧栏的宽度可以调整。
- 大于 10 MB 的文件以只读方式打开,且只显示前 10 MB,以免保存时截断文件的其余部分。
- 右键点击文档标签页,除常规的关闭操作外,还提供「刷新文件」;Markdown 文档还提供「导出 PDF」。
1.4 新建文档与导出 PDF
- 「新建文档」会打开一个空白草稿,它尚未保存到磁盘,也不会出现在项目树中。首次保存时会询问存放位置:桌面版使用系统的“另存为”对话框,浏览器客户端和远程连接窗口则显示一个“另存为”对话框,用于选择运行会话的那台机器上的位置。语法高亮会根据所选的文件名确定。右键点击草稿的标签页,还可以选择「保存到磁盘…」。
- 「导出 PDF」会将 Markdown 文档转换为矢量 PDF,自动分页并嵌入中日韩字体。桌面版会询问保存位置;浏览器客户端则直接下载该文件。
2. 浏览器标签页(仅限桌面版)
浏览器标签页在 VelaTerm 中显示真实的网页,便于把文档、issue 页面或本地预览放在会话旁边。浏览器标签页仅在桌面版中可用,浏览器客户端、远程连接窗口和移动端布局中均不提供。
打开浏览器标签页:
- 标签栏右端的「内置浏览器」按钮;
- 快捷键 ⌘⇧B;
- 在会话中运行
vopen <URL>; - 左栏中项目或分组右键菜单里的「新建浏览器页面」。
工具栏:「后退」「前进」「刷新」(页面加载时为「停止加载」)、地址栏(「输入网址或搜索词」;输入的内容不是网址时,会用 Google 搜索)、「在系统浏览器中打开」,以及包含 ChatGPT、Claude、Gemini 和 Google 的「快速访问」栏。
两种形式:
- 浏览器标签页:通过上述按钮、⌘⇧B 或
vopen <URL>打开。它不会保存在项目树中,重启后不再保留。 - 浏览器页面节点:通过「新建浏览器页面」创建。它是项目树中的一个节点,会记住自己的地址,重启后依然存在。
在新窗口中打开的链接:当网页在新窗口中打开链接时(例如 target="_blank" 链接),VelaTerm 会在新的浏览器标签页中打开它。
独立页面:标签栏右端的「游戏中心」按钮会以独立页面的形式打开 VelaTerm 游戏中心。独立页面没有地址栏和快速访问栏,只有「后退」「前进」和「刷新」;在其中打开的链接会留在同一个标签页中。
安全边界:内嵌网页被视为普通的外部网站。它不会获得 VelaTerm 的任何权限或凭据,并且只能打开 http 和 https 地址。
3. 各类标签页如何共存
- 会话、文档和浏览器标签页共用一个标签栏,⌘1–9 可以在所有这些标签页之间切换。
- 从项目树中打开会话时,只会复用会话标签页;文档和浏览器标签页永远不会被替换。
- 文档和浏览器标签页不能分屏。⌘W 会直接关闭它们(有未保存修改的文档会先询问)。