# 可视化编辑器

编写文档、编辑受支持的组件，并随时切换到源码。

## 打开文档

从内容列表打开 Markdown 或 MDX 文档，通过文档上方的模式切换按钮选择可视化或源码模式。文档无法解析为可视化内容时，可以在源码模式中修复。

## 插入内容与调整格式

输入 `/` 打开插入菜单，可用内容块由 Collection 的编辑器配置决定。选中文字后会显示格式工具；将鼠标移到内容块上，可以找到移动手柄和选项菜单。

主工具栏提供撤销、重做和选择图片等操作。各内容块也有自己的控件，例如表格的行菜单、提示块的类型选择器。具体用法见 [Markdown 基础语法](/docs/zh-cn/editor/markdown/)和各 MDX 组件文档。

<figure>
  <video
    src="https://media.prosefly.com/_video/visual-editor-1.mp4"
    width="1920"
    height="1080"
  ></video>
  <figcaption>在可视化模式中编辑 Markdown 内容和 Steps 组件。</figcaption>
</figure>

## 属性、大纲与专注模式

属性面板显示 Collection 的 schema 中可编辑的 frontmatter 字段，例如标题、日期和标签。大纲列出文档标题，方便跳转。专注模式会为文档腾出更多空间；在较窄的屏幕上，属性面板通过抽屉打开。

Starlight Collection 的属性面板会显示受支持的原生字段。下图展示 Pagefind、Template，以及 Edit URL、Head 等字段，正文中包含标签页和提示块。实际可编辑的属性取决于 Collection 的 schema 和编辑器配置。

<figure>
  <img
    src="/images/screenshots/starlight/properties.png"
    alt="在 Prosefly 中打开的 Starlight Getting Started 指南，正文包含标签页和提示块，属性面板展示 Pagefind 等原生字段。"
    width="2880"
    height="1620"
    loading="lazy"
    decoding="async"
  />
  <figcaption>Starlight 示例：在同一个界面中编辑正文和受支持的原生页面属性。</figcaption>
</figure>

## 网站导航

**Outline** 是当前文档的标题大纲；**Navigation** 是网站的页面结构。内容集合确认了受支持的导航绑定后，才会提供网站导航编辑。

在 Navigation 面板中，可以将页面安排到已有的可写分组，并调整受支持的条目顺序。打开审阅前，请等待导航保存完成。保存位置调整不会产生 Git 提交。

面板操作与支持范围见[管理网站导航](/docs/zh-cn/repositories-and-spaces/#管理网站导航)。发布前，再[一起审阅正文和导航](/docs/zh-cn/publishing/#正文和导航一起审阅)。

## 使用源码模式

源码模式显示完整文件，包括 frontmatter、MDX import 和自定义语法。没有专用可视化控件的内容，可以在这里修改。遇到本地恢复提示时，请先与当前共享文档比较，再决定是否恢复。

## 保存与审阅

可视化修改会自动保存，离开前请等待保存完成。macOS 上按 `⌘S`，其他平台按 `Ctrl+S`，可以备份本地源码并保存共享草稿。保存不会产生 Git 提交。

草稿准备好后，打开[发布审阅](/docs/zh-cn/publishing/)，检查源码差异和受影响的导航文件，再发布到仓库。

## AI 写作与翻译

选中同一个文本块中的文字，可以改写或检查拼写和语法。[AI 写作](/docs/zh-cn/editor/ai-writing/)介绍直接替换、逐条校对建议和点数的使用。需要翻译整篇文章时，请使用[语言与翻译](/docs/zh-cn/languages-and-translation/)中的流程。两种操作都只修改草稿，结果需要由你审阅。