跳到主要内容

Sample 合同 · MD 指令 · ARC 2.0.0-beta.28

`:::step`

在 steps 下嵌套单步正文；完整 live sample 与 steps 容器同页。

Web Device Markdown 指令——不是 AUP primitive；不是 theme/site layout 组件。

Sample 合同

字段值
目的::::steps 内的单步容器
边界必须嵌在 ::::steps 下；叶 ::step 不能承载正文
作者入口:::step{title=…} 嵌在 ::::steps 下
表面Web Device document（steps 的子 view）
公共状态released
Fallback / 失败在 steps 外 → 无完整 steps chrome；fence 错误 → 空正文
验证配对页 steps · arc --version = 2.0.0-beta.28

Sample

:::step 仅在 ::::steps 内有意义。完整 fence 规则与 live 渲染：

源码（必须嵌套）：

markdown
::::steps
:::step{title="One unit, one body"}
This body is a step item. It is not a free-standing tutorial primitive.
:::
::::

渲染：

  1. One unit, one body

    This body is a step item. It is not a free-standing tutorial primitive.

更完整的多步 sample 见 steps。

失败与限制

情形预期结果
无外层 ::::steps 的 :::step无完整 steps 合同
叶 ::step不能承载正文
缺 titlestep 仍可能渲染；标题 chrome 省略

验证证据

项值
基线2026-08-09 · arc --version → 2.0.0-beta.28
能力行docs/aup/capability-matrix.md §6 · :::step
实现content-reader.ts（子名 step）· stepsDirectiveToAup
公开路由/en/docs/web-device/markdown/step/ · /zh/docs/web-device/markdown/step/
本地运行arc service start --blocklet blocklets/arcblock --port 4900 · 打开本页与 steps
接受标准嵌套 step 正文在 steps chrome 内渲染

相关