文稿格式
页面、对象、备注与新文稿的保存方式。
Presentor 文稿由 YAML 文稿设置、页面分隔线和对象组成。Source 中的 Markdown 是保存内容，画布和文本视图都修改这份内容。
文件开头的一对 --- 包住文稿设置；后面的单独一行 --- 分隔页面。新文稿在设置中使用 textFormat: markdown。旧文稿不自动改写。
对象声明记录 ID、位置、尺寸与样式：
<!= textbox id="claim" type=text font="Noto Sans SC Variable" size=36 pos="8,20" width=1300 textSizing=auto-height >
正文中的 **强调** 与 $x^2$。尺寸模式为 auto-width（随文字宽度）、auto-height（固定宽度、自动高度）或 fixed（固定宽高）。pos 以页面百分比定位，width 和 height 使用画布坐标。固定高度需要显式保存 height。
正文的行内公式使用 $…$，独立公式使用 $$…$$。编辑时保留美元符号，删除分隔符即可改成普通文字。
页面末尾的备注不会显示在观众页：
<!-- presenter-notes
这里写演讲备注。
-->复制页面会保留跨页公式对象 ID；同页复制生成新 ID。公式连续变化依赖稳定 ID、字形对应与锚点设置。排版位置始终由文稿决定。
图形使用显式形状字段，表格正文使用标准 Markdown 表格并可保存相对列宽。媒体对象使用 type=media，media 字段保存类型、标题与播放设置，正文保存附件地址或内嵌数据。建议先在画布插入对象，再在 Source 查看完整声明。
无效 Source 会显示错误并保留最后一份有效画布；修正错误后再保存。不会把解析失败当成空白文稿。
工作台字段只在新建页面或明确使用对应功能时写入。旧文稿、浏览器历史和本地快照不批量迁移。
| 保存位置 | 字段 | 含义 |
|---|---|---|
| 文稿设置 | attachments | 保留导入 PDF 的 ID、名称、类型和资源地址；项目包收集原件 |
| 页面设置 | pageId、section | 稳定页面身份与节标题；复制页面生成新页面身份 |
| 页面设置 | guides、snapGrid | 参考线轴向/位置；实验网格开关和步长 |
| 页面设置 | comments | 批注正文、对象 ID 或页面坐标、解决状态 |
| 对象声明 | layer、rotation | 图层名称、显隐/锁定与旋转角度 |
| 对象声明 | imageEditing | 角点比例规则、百分比裁剪、裁剪形状、曝光和色温 |
| 对象声明 | effects、mask | 显式对象效果与相对图片坐标的蒙版多边形 |
复杂字段由界面生成并经过中央解析器验证。在 Source 调整前，可先复制一个使用该功能的对象查看完整声明。图层隐藏会影响画布、缩略图与放映；锁定只约束编辑。演示笔迹另存 SVG 文件，不写进这些对象字段。