Web Device 的内容读取器会把 Markdown 中的 GFM 表格和 GitHub 风格提示变成文档内容。下面的 source 和 result 由同一条文档读取路径产生。它们不是泛用的 AUP table 或 text primitive 合同,也不要据此假定 AUP 页面中的 format: markdown 会得到相同结果。
本页是 feature live 指南。unit 页:gfm-table、gfm-admonition。
Sample 合同
| 字段 | 值 |
|---|---|
| 用途 | 在内容 Markdown 中写静态 GFM 表格与 admonition 提示 |
| 边界 | 不是可编辑表格;不是 AUP table 节点;不是 chart 降级表;无写入路径 |
| 作者入口 | 管道表格 · content.md 中的 > [!NOTE] 风格引用 |
| 表面 | Web Device document(静态) |
| 公共状态 | released |
| Fallback / 失败 | 未知 admonition marker → 普通引用;裸 marker 使用 locale 默认标题 |
| 验证 | 下列路由 · arc --version = 2.0.0-beta.32 |
GFM 表格
源代码:
| 文件 | 用途 | 是否写入 |
| --- | --- | --- |
| `content.md` | 内容对象 | 否 |
| `layout.aup` | 页面布局 | 否 |渲染结果:
| 文件 | 用途 | 是否写入 |
|---|---|---|
content.md | 内容对象 | 否 |
layout.aup | 页面布局 | 否 |
这是一张由内容读取器处理的 Markdown 表格(在 document tree 中常表现为 HTML text)。它没有把表格变成可编辑数据,也没有建立 AFS data source,更不能证明 AUP primitive table 路径。不要把 chart 降级产生的空表(No data / reshape)与这张作者写的 GFM 表混为一谈。
失败与限制
| 情况 | 预期结果 |
|---|---|
| 管道格式错误 | 普通 Markdown / 破损表格,不是运行时错误面 |
| 空数据行 | 仅作者内容 — 不会自动出现 chart 链的 “No data” 外壳 |
假定 AUP table props | 错误表面;需要该节点时写 AUP JSON/DSL |
GitHub 风格提示
源代码(marker 行带自定义标题):
> [!IMPORTANT] 这是内容文件能力
> 这类提示写在 `content.md` 中。页面只呈现作者写下的内容,不会执行 action 或修改资料。渲染结果:
这是内容文件能力
这类提示写在 content.md 中。页面只呈现作者写下的内容,不会执行 action 或修改资料。
裸 marker(同一行没有标题)使用读取器按内容 locale 写入的默认标签。英文内容保留 text renderer 的英文默认值;zh 在读取时套用:
| Marker | zh 默认标题 |
|---|---|
NOTE | 说明 |
TIP | 提示 |
IMPORTANT | 重要 |
WARNING | 警告 |
CAUTION | 注意 |
任意 locale 下,同一行的显式标题都优先于 locale 默认值。
源代码(裸 marker — 标签来自 locale 默认):
> [!TIP]
> 当英文 marker 词不是你想要的标签时,优先写同一行的自定义标题。渲染结果:
提示
当英文 marker 词不是你想要的标签时,优先写同一行的自定义标题。
当前识别 NOTE、TIP、IMPORTANT、WARNING 与 CAUTION 五种 marker(大小写不敏感)。未知 marker 保持普通引用,不会被转换成另一种提示类型。
失败与限制
| 情况 | 预期结果 |
|---|---|
[!FIXME] 或其他未知 marker | 普通引用,不是 callout 外壳 |
| marker 不在引用的第一行 | 不被识别为 admonition |
| 期望关闭按钮或编辑器 | 仅静态文档内容 |
内容对象中的 GFM 表格和提示是静态文档内容。要写运行态 AUP tree,应把这条文档读取路径和其 renderer 定义的 target-specific primitive 支持范围分开;面向本站的边界见AUP layout 边界。
验证证据
| 项 | 值 |
|---|---|
| 基线 | 2026-08-12 · arc --version → 2.0.0-beta.32 |
| 能力行 | docs/aup/capability-matrix.md (internal, non-routed) · GFM admonition · GFM table |
| 实现 | providers/runtime/web-device/src/content-reader.ts(ADMONITION_MARKER_RE、ADMONITION_LOCALIZED_LABELS);text admonition renderer |
| 公开路由 | /zh/docs/web-device/markdown-gfm-callouts/ · /en/docs/web-device/markdown-gfm-callouts/ |
| 本地运行 | arc service start --blocklet blocklets/arcblock --port 4900 · 打开路由;zh locale 下裸 marker 显示中文默认标题 |
| 验收 | source 与渲染的表格/提示一致;未知 marker 仍是引用;无可编辑控件 |