Skip to content

富文本 Markdown 编辑器 ​

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

斜杠菜单 ​

在空行上输入 / 以打开斜杠菜单:标题、列表、代码块、callout、图片、mermaid 图表和折叠块。

对于可折叠的注释使用 /toggle-text,当折叠摘要需要像某个标题级别那样显示时使用 /toggle-h1 … /toggle-h5。DevAgent 将折叠块保存为可移植的 <details> / <summary> markdown,因此该文件在 DevAgent 之外仍能正常预览。

内部链接 ​

输入 [[ 以开始一个 wiki 风格的链接。DevAgent 会自动补全 worktree 内的文件路径并插入一个相对链接。

搜索 ​

编辑器内的 markdown 搜索针对的是渲染后的文本,而非原始 markdown——因此搜索 "Install" 时,无论标题写作 # Install 还是 <h1>Install</h1>,都能找到。

审查批注 ​

当你在 DevAgent 的富文本编辑器中审查 markdown 时,选中渲染后的文本即可添加批注,无需切回原始 markdown。DevAgent 会将该注释与所选源码范围绑定,因此在你继续编辑渲染文档时,它仍能显示这条评论。

Add Review Note 是一个可重新映射的快捷键(在 设置 → 快捷键 下默认为 Cmd+Shift+A / Ctrl+Shift+A)。

Front matter ​

YAML 和 TOML front matter 默认会在富文本编辑器和渲染预览中显示,这样文档和静态站点文章无需切回原始 markdown 就能暴露其元数据。当你想要只看正文的视图时,打开编辑器的 More actions(…)菜单并选择 Hide front matter;同一菜单可将其切回 Show front matter。该切换是按文件生效的,因此在一个文档上隐藏它并不会隐藏其余文档中的 front matter。

表格 ​

在富文本 markdown 表格中:

Key

Behavior

标签页 / Shift-标签页

下一个 / 上一个单元格;在最后一个单元格上按 Tab 会插入一行

Enter

移动到下方单元格;在最后一行时,新增一行

Backspace(在完全为空的行上)

删除该行(如果它是最后一行,则删除整个表格)

Backspace(在空单元格中,且该行仍有内容时)

退到上一个单元格

当光标位于表格中时,富文本编辑器工具栏会显示一键式的行和列插入/删除控件。右键点击表格单元格可在上下文菜单中获得相同的结构命令(Table 子菜单仅在目标为表格单元格时出现)。

目录 ​

对于长文档,点击编辑器标题栏中的 Table of Contents 按钮(树形图标),可打开一个固定在编辑器左侧的标题大纲。点击某个标题会跳转到它;折叠和展开控件让层级很深的章节保持可读。在富文本和预览模式下均可用。

Share as artifact ​

在编辑器标题栏中,Share as artifact 会通过你已登录的 DevAgent 账号将打开的 Markdown 文件发布为一个公开查看链接。需要 设置 → Artifacts → Allow publishing public artifact links(默认关闭)。当 DevAgent 仍保留着映射时,重新发布会更新同一个链接;可从侧栏的 Artifacts 页面管理或删除链接。agent 和脚本可以使用 devagent artifacts share|update|list|delete——参见 CLI reference → Artifacts。

DevAgent 桌面客户端文档