# 编辑内容

可视化编写、编辑源码并管理文档属性。

## 可视化与源码模式

从 Content 打开条目。Visual 模式为支持的 Markdown 和 MDX 提供内容视图，Source 模式可编辑完整文档，包括 frontmatter 和 MDX import。

可视化编辑器不会执行仓库代码。自定义 MDX 组件的呈现可能与部署网站不同。格式错误的文档仍可在 Source 中修复。

## 文档组件

除了通用的 Markdown 和 MDX 编辑，Prosefly 还为 Starlight、Fumadocs 和 `@prosefly/astro-components` 提供专门的编辑器配置，识别提示块、标签页、卡片、步骤和文件树等文档组件所支持的语法与属性。不同配置支持的组件有所不同；Fumadocs 和 Prosefly 组件还支持折叠面板。

具体支持由 Collection 的编辑器配置决定。自定义组件和不支持的表达式仍可在源码中编辑。组件适配不会执行仓库代码，也不会复现网站的完整布局。

## 属性与大纲

在 Properties 中编辑标题、日期、标签等字段。字段由 Collection 识别到或配置的 schema 决定。可视化内容和属性变更保存为同一份完整文档。

Outline 帮助跳转标题，Focus 模式给文档更多空间。较窄的工作区通过抽屉显示属性。

## 保存草稿

离开前确认文档保存和协作状态。草稿保存在 Prosefly，不会提交到 Git。源码编辑可能保留本地恢复副本；遇到恢复提示时，请与当前共享文档比较后再继续。

## 添加图片

通过编辑器上传，或从媒体库选择已就绪图片。已有仓库图片在 Visual 模式中保留 Markdown 路径。相对路径从内容文件解析，根路径使用 Space 的公开目录。

仓库图片与上传媒体采用不同保存方式。[阅读媒体指南](/docs/zh-cn/media/)。

## 检查结果

[发布审阅](/docs/zh-cn/publishing/)展示写入 Git 前的真实源码差异。需要验证框架特定渲染时，请使用网站原有构建流程预览。