Web Device Markdown 指令——不是 AUP primitive;不是 theme/site layout 组件。
Sample 合同
| 字段 | 值 |
|---|---|
| 目的 | document 上的静态编号教程容器 |
| 边界 | 仅静态——无运行按钮、bind 或写入;外层 fence 深于嵌套 step |
| 作者入口 | ::::steps 包裹 :::step 子节点 |
| 表面 | Web Device document(渲染为 view mode steps) |
| 公共状态 | released |
| Fallback / 失败 | fence 深度错误会丢/错解正文;非 step 子节点被跳过 |
| 验证 | 下方路由 · arc --version = 2.0.0-beta.28 |
Sample
外层 fence 的冒号数必须多于内层。
源码:
::::steps
:::step{title="Define the content boundary"}
Say what the page presents, and what it does not execute.
:::
:::step{title="Place source above the result"}
Let the reader see both the Markdown and its actual output.
:::
::::渲染:
Define the content boundary
Say what the page presents, and what it does not execute.
Place source above the result
Let the reader see both the Markdown and its actual output.
失败与限制
| 情形 | 预期结果 |
|---|---|
| 外层 fence 过浅 | 结构误读;steps 可能丢失 |
:::step 在 ::::steps 外 | 本页无完整 steps chrome 合同 |
| 期望可执行运行按钮 | 超出合同 |
验证证据
| 项 | 值 |
|---|---|
| 基线 | 2026-08-09 · arc --version → 2.0.0-beta.28 |
| 能力行 | docs/aup/capability-matrix.md §6 · ::::steps |
| 实现 | content-reader.ts · stepsDirectiveToAup · renderer/primitives/view.ts |
| 公开路由 | /en/docs/web-device/markdown/steps/ · /zh/docs/web-device/markdown/steps/ |
| 本地运行 | arc service start --blocklet blocklets/arcblock --port 4900 · 打开路由 |
| 接受标准 | 静态编号 steps 渲染;无执行控件 |
相关
- Markdown hub — 仅导航
- 配对单元:step
- AUP
viewprimitive - 历史多单元 hub:markdown-steps