文档 / 编辑 / 富 Markdown 编辑器

Markdown 文件默认在富文本编辑器中打开——支持斜杠菜单、工具栏、图片和代码的内联预览，以及内部链接自动补全。随时可按 Cmd-Shift-M 切换到原始 Monaco 编辑器。

对于大于 300 KB 的文件，Orca 会先打开原始编辑器以保持输入响应。如果你希望对该文件使用富文本编辑器，请在回退横幅中选择 仍然打开；该选择会持续到你关闭其标签页。使用富文本编辑器无法安全保留的 Markdown 结构的文件仍会保留在原始编辑器中。

斜杠菜单¶

在空行中输入 / 以打开斜杠菜单：标题、列表、代码块、提示框、图片、mermaid 图表和切换块。

使用 /toggle-text 创建可折叠笔记，或者当切换摘要应显示为标题级别时使用 /toggle-h1 … /toggle-h5。你可以就地编辑嵌套切换块。Orca 会将切换块保存为可移植的 <details> / <summary> Markdown，因此该文件在 Orca 外部仍可预览。

内部链接¶

输入 [[ 开始创建 wiki 风格链接。Orca 会自动补全工作树内的文件路径，并插入相对链接。

搜索¶

编辑器内的 Markdown 搜索基于渲染后的文本，而不是原始 Markdown——因此搜索 "Install" 可以找到一个标题，无论它写作 # Install 还是 <h1>Install</h1>。

审阅批注¶

当你在 Orca 的富文本编辑器中审阅 Markdown 时，选择渲染后的文本即可添加批注，无需切换回原始 Markdown。Orca 会将笔记关联到所选的源文本范围，因此在你继续编辑渲染文档时仍可显示该评论。

添加审阅笔记 是一个可重新映射的快捷键（默认在 设置 → 快捷键 下为 Cmd+Shift+A / Ctrl+Shift+A）。

前置元数据¶

默认情况下，YAML 和 TOML 前置元数据会在富文本编辑器和渲染预览中显示，以便文档和静态站点文章无需切换回原始 Markdown 即可展示其元数据。打开编辑器的 更多操作（…）菜单，选择 隐藏前置元数据 以查看仅正文视图；同一菜单可将其切换回 显示前置元数据。该切换按文件生效，因此在一个文档中隐藏它不会在其他文档中隐藏。

表格¶

在富 Markdown 表格中：

使用 Shift-Tab 取消列表项或代码块中选中行的缩进。

当光标位于表格中时，富文本编辑器工具栏会显示一键 插入/删除行和列 控件。右键单击表格单元格可在上下文菜单中访问相同的结构命令（仅当目标是表格单元格时才会显示表格子菜单）。

目录¶

对于长文档，点击编辑器标题栏中的 目录 按钮（树形图标）可打开固定在编辑器左侧的标题大纲。点击标题可跳转到该位置；折叠和展开控件可保持深度嵌套章节的可读性。在富文本模式和预览模式下均可用。

共享为工件¶

从编辑器标题栏中，共享为工件 会通过你已登录的 Orca 账户将当前打开的 Markdown 文件发布为公开查看链接。需要启用 设置 → 工件 → 允许发布公开工件链接（默认关闭）。当 Orca 仍保留映射时，重新发布会更新同一链接；可在侧边栏的 工件 页面管理或删除链接。智能体和脚本可以使用 orca artifacts share|update|list|delete——参见 CLI 参考 → 工件。