跳到主要内容

Live 指南 · ARC 2.0.0-beta.32

在 Markdown 中写表格与提示

把 GFM 表格和 GitHub 风格提示直接放入 Web Device 内容对象,并在同一页检查实际输出。

Web Device 的内容读取器会把 Markdown 中的 GFM 表格和 GitHub 风格提示变成文档内容。下面的 source 和 result 由同一条文档读取路径产生。它们不是泛用的 AUP tabletext primitive 合同,也不要据此假定 AUP 页面中的 format: markdown 会得到相同结果。

本页是 feature live 指南。unit 页:gfm-tablegfm-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 表格

源代码:

markdown
| 文件 | 用途 | 是否写入 |
| --- | --- | --- |
| `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 行带自定义标题):

markdown
> [!IMPORTANT] 这是内容文件能力
> 这类提示写在 `content.md` 中。页面只呈现作者写下的内容,不会执行 action 或修改资料。

渲染结果:

这是内容文件能力

这类提示写在 content.md 中。页面只呈现作者写下的内容,不会执行 action 或修改资料。

裸 marker(同一行没有标题)使用读取器按内容 locale 写入的默认标签。英文内容保留 text renderer 的英文默认值;zh 在读取时套用:

Markerzh 默认标题
NOTE说明
TIP提示
IMPORTANT重要
WARNING警告
CAUTION注意

任意 locale 下,同一行的显式标题都优先于 locale 默认值。

源代码(裸 marker — 标签来自 locale 默认):

markdown
> [!TIP]
> 当英文 marker 词不是你想要的标签时,优先写同一行的自定义标题。

渲染结果:

提示

当英文 marker 词不是你想要的标签时,优先写同一行的自定义标题。

当前识别 NOTETIPIMPORTANTWARNINGCAUTION 五种 marker(大小写不敏感)。未知 marker 保持普通引用,不会被转换成另一种提示类型。

失败与限制

情况预期结果
[!FIXME] 或其他未知 marker普通引用,不是 callout 外壳
marker 不在引用的第一行不被识别为 admonition
期望关闭按钮或编辑器仅静态文档内容

内容对象中的 GFM 表格和提示是静态文档内容。要写运行态 AUP tree,应把这条文档读取路径和其 renderer 定义的 target-specific primitive 支持范围分开;面向本站的边界见AUP layout 边界

验证证据

基线2026-08-12 · arc --version2.0.0-beta.32
能力行docs/aup/capability-matrix.md (internal, non-routed) · GFM admonition · GFM table
实现providers/runtime/web-device/src/content-reader.tsADMONITION_MARKER_READMONITION_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 仍是引用;无可编辑控件