Skip to main content

Sample contract · MD directive · ARC 2.0.0-beta.28

`::::steps`

Author a static numbered tutorial with steps/step fences and inspect the real document render.

Web Device Markdown directive — not an AUP primitive; not a theme/site layout component.

Sample contract

FieldValue
PurposeStatic numbered tutorial container on document
BoundariesStatic only — no run button, bind, or write; outer fence deeper than nested step
Author entry::::steps wrapping :::step children
SurfaceWeb Device document (renders as view mode steps)
Public statusreleased
Fallback / failureWrong fence depth drops or misparses body; non-step children skipped
VerificationRoutes below · arc --version = 2.0.0-beta.28

Sample

Outer fence needs more colons than nested containers.

Source:

markdown
::::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.
:::
::::

Rendered:

  1. Define the content boundary

    Say what the page presents, and what it does not execute.

  2. Place source above the result

    Let the reader see both the Markdown and its actual output.

Failure and limits

SituationExpected result
Outer fence too shallowStructure misread; steps may drop
:::step outside ::::stepsNo full steps chrome contract on this page
Expecting executable run buttonsOut of contract

Verification evidence

ItemValue
Baseline2026-08-09 · arc --version → 2.0.0-beta.28
Capability rowdocs/aup/capability-matrix.md §6 · ::::steps
Implementationcontent-reader.ts · stepsDirectiveToAup · renderer/primitives/view.ts
Public routes/en/docs/web-device/markdown/steps/ · /zh/docs/web-device/markdown/steps/
Local runarc service start --blocklet blocklets/arcblock --port 4900 · open routes
AcceptNumbered static steps render; no execution controls

Related