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

`::link-card`

Organize a navigation entry with link-card and inspect its read-only rendered result in place.

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

Sample contract

Field	Value
Purpose	Navigation card in content Markdown
Boundaries	Navigation only; no `exec`, AFS write, or session; not a `.web` component API
Author entry	`::link-card{title=… description=… href=… icon=…}`
Surface	Web Device document (static)
Public status	`released`
Fallback / failure	No safe `href` → non-link card chrome
Verification	Routes below · `arc --version` = `2.0.0-beta.28`

Source:

::link-card{title="Web Device overview" description="Review the site structure and its boundary" href="/en/docs/web-device/overview/" icon="book"}

Rendered:

Web Device overview

Review the site structure and its boundary

Source without href (not a navigation target):

::link-card{title="Not a link" description="Missing href stays non-interactive chrome"}

Rendered:

Not a link

Missing href stays non-interactive chrome

Situation	Expected result
Missing `href`	Non-link presentation
Unsafe `href` scheme	Not promoted as a safe navigation target
Expecting `exec` or form submit	Out of contract

Item	Value
Baseline	`2026-08-09` · `arc --version` → `2.0.0-beta.28`
Capability row	`docs/aup/capability-matrix.md` §6 · `::link-card`
Implementation	`content-reader.ts` · `contentCardToAup`
Public routes	`/en/docs/web-device/markdown/link-card/` · `/zh/docs/web-device/markdown/link-card/`
Local run	`arc service start --blocklet blocklets/arcblock --port 4900` · click link-card → ordinary navigation only
Accept	Source matches card; missing `href` is not a link; no write/`exec`