编辑器概览
理解 Anydocs 里的编辑器定位,以及 canonical 内容模型和上游编辑器引擎的关系。
Anydocs 在 Studio 里使用 Yoopta 作为编辑引擎,但页面最终保存的是 canonical `DocContentV1`。这里开放的只是文档写作所需的那一组能力。它的职责是帮助你写结构化文档,不是把页面搭成营销站或低代码布局。阅读上游 Yoopta 资料时,应把它当作编辑器背景,而不是产品 contract。
它在 Anydocs 里负责什么
Yoopta 在这里承担 Studio 正文编辑引擎角色。你会在中间编辑区里用它编写段落、标题、列表、代码、表格、图片、提示框、链接和 Mermaid 图表,而保存到页面源文件时会被规范化成 canonical 内容块。页面标题、slug、描述、标签和状态则在页面元数据侧管理,不属于正文编辑器本身。
真实的起手方式
空页面进入编辑态后,编辑器会先落一个段落块。你可以直接输入,也可以输入 `/` 调出块菜单,再插入目标块。块级顺序可以通过编辑器里的拖拽手柄调整。对于大多数文档页,推荐先用段落和二三级标题搭出主结构,再补代码、表格、提示框和图片。
当前开放的能力边界
当前 Anydocs 开放的是文档型块,而不是布局型容器。支持的内容以本手册以及 `project_open.authoring.contentFormat`、`allowedBlockTypes`、`allowedMarks` 为准。即便上游 Yoopta 生态还有更多插件,也不能默认它们已经在 Anydocs 中可用。
和 reader 的关系
canonical 内容会被 reader、目录提取、全文文本导出和机器可读产物直接消费。因此正文结构不是只给编辑时看,最终也会影响 reader 的目录、阅读节奏与 AI 消费效果。比如二三级标题会被用来提取页面目录,而行内 code 与独立代码块会在 reader 中以不同方式呈现。