本组文档只描述写在 Web Device 内容对象 content.md 中的 Markdown。内容读取器会把它读成 AUP tree，再由当前 document target 渲染成页面内容。它不是 AUP text primitive 中 format: markdown 的完整语法参考，也不是 .web component catalog。
每一页都把 author 写下的 source 直接放在真实结果上方，并写明这个结果证明什么、刻意不证明什么。文档本身只读。某些组件可能有自身的有限交互，例如切换 tab；这不会让读者编辑 source、manifest、内容对象或持久数据。
已验证的内容 Markdown 结构
| 要写什么 | 从这里开始 | 结果边界 |
|---|---|---|
| YouTube、X/Twitter 或同站内容嵌入 | 嵌入外部和内部内容 | 只支持受识别的 provider URL 与经过校验的同站路径；这不是 AUP session 或 bridge |
| 带 inline player 的可读 presentation | Markdown Slides | slides: true 定义分页，named layout 挂载播放器；它不提供 presenter view 或自由定位 canvas |
| GFM 表格与提示 | 表格与提示 | 呈现静态内容，不建立可编辑表格或 data source |
| 导航卡片与说明卡片 | Markdown 卡片 | link 只做普通导航；没有 exec、写入或编辑权限 |
| 编号教程 | Markdown 步骤 | 呈现静态的步骤 body，不执行每一步中的动作 |
先选对层
如果目标是可复用站点 layout section，从 .web/components 和页面 layout.aup 开始。它有自己的 manifest 与 renderer 合同，不能用一条 Markdown directive 代替。
如果目标是一个跨设备、可交互的 AUP tree，从 AUP app、目标 renderer 与 session 语义开始。静态文档 target 看到一次 HTML 输出，不等于已经验证 event、patch、data binding 或其他设备。
这三个层次的具体边界见组件解析与AUP 在 Web Device 中。