第30章 Orca 第30章：富文本 Markdown 编辑器功能详解
富文本 Markdown 编辑器 Markdown 文件默认以富文本编辑器打开——支持斜杠菜单、工具栏、图片和代码的内联预览、内部链接自动补全。随时可以用 Cmd-Shift-M 切换回原始 Monaco 编辑器。
Orca 在 macOS、Windows 和 Linux 上将 Markdown 文件注册为可用的“打开方式”应用，不会接管你现有的默认编辑器。想用富文本编辑器打开文件时，从操作系统的文件关联菜单中选择 Orca 即可。
富文本 Markdown 编辑器——斜杠菜单、内联预览、内部链接自动补全
对于超过 600 KB 的文件，Orca 会先以原始编辑器打开，以保证输入流畅。如果想对该文件使用富文本编辑器，在提示横幅中选择“仍然打开”，此选择会一直生效到关闭该标签页。使用了富文本编辑器无法安全保留的 Markdown 结构的文件，仍会在原始编辑器中打开。
斜杠菜单
在空行输入 / 打开斜杠菜单：标题、列表、代码块、提示框、图片、mermaid 图表和折叠块。
用 /toggle-text 创建可折叠笔记，或用 /toggle-h1 … /toggle-h5 让折叠块的摘要看起来像标题层级。可以就地编辑嵌套的折叠块。Orca 将折叠块保存为可移植的 markdown，文件在 Orca 之外也能正常预览。
提示框（Callouts）
GitHub 风格的警告会渲染成带标题的彩色方框。如果引用块的第一行是 > [!NOTE]、> [!TIP]、> [!IMPORTANT]、> [!WARNING] 或 > [!CAUTION]，就会显示对应的图标和标题，而不是保留标记文本的普通引用。这适用于 Orca 只读渲染 Markdown 的所有场景，包括预览。
内部链接
输入 [[ 开始创建 wiki 风格链接。Orca 会自动补全 worktree 内的文件路径并插入相对链接。
搜索
编辑器内的 Markdown 搜索基于渲染后的文本而非原始 markdown——所以搜索"Install"时，无论标题写作 # Install 还是其他形式都能找到。
评审批注
在 Orca 富文本编辑器中审阅 markdown 时，选中渲染后的文本即可添加批注，无需切回原始 markdown。Orca 会把笔记关联到所选的源文本范围，让你在继续编辑渲染文档的同时看到批注。
Add Review Note 是可自定义的快捷键（默认为 Cmd+Shift+A / Ctrl+Shift+A，见 Settings → Shortcuts）。
Front matter
YAML 和 TOML front matter 默认在富文本编辑器和渲染预览中显示，让文档和静态网站文章无需切换到原始 markdown 就能展示元数据。想只看正文，打开编辑器的 More actions（…）菜单并选择 Hide front matter；同一菜单也可切换回 Show front matter。此切换按文件生效，在一个文档中隐藏不会影响其他文档。
表格
在富文本 Markdown 表格中：
| 按键 | 行为 |
|---|---|
| Tab / Shift-Tab | 跳到下一个/上一个单元格；在最后一个单元格按 Tab 会插入新行 |
| Enter | 移到下方单元格；在最后一行时新增一行 |
| 在完全空行上按 Backspace | 删除该行（如果是最后一行则删除整个表格） |
| 在行内还有内容时空单元格中按 Backspace | 跳到上一个单元格 |
用 Shift-Tab 可以取消列表项缩进，或取消代码块中选中行的缩进。
光标位于表格内时，富文本编辑器工具栏会显示一键插入/删除行和列的控件。右键点击表格单元格可在上下文菜单中找到相同的结构命令（只有目标是表格单元格时才会出现 Table 子菜单）。
目录
对于长文档，点击编辑器头部的目录按钮（树状图标）可在编辑器左侧固定打开标题大纲。点击标题即可跳转；折叠和展开控件让深层嵌套的章节更易浏览。富文本和预览模式下均可用。
分享为 artifact
在编辑器头部，Share as artifact 可通过已登录的 Orca 账户将当前打开的 Markdown 文件发布为公开查看链接。支持最大 10 MiB 的文件。需要在 Settings → Artifacts → Allow publishing public artifact links 中开启（默认关闭）。当 Orca 仍保留映射关系时，Republish 会更新同一链接；可在侧边栏 Artifacts 页面管理或删除链接。Agent 和脚本可以使用 orca artifacts share|update|list|delete——参见 CLI reference → Artifacts。
