`slides: true` front matter

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

Sample 合同

字段	值
目的	将顶层 HR 变为幻灯片边界并挂载 slides player 路径的 YAML 标志
边界	无 flag → 普通文章；无 widget → 仅服务端 transcript；不是自由画布
作者入口	`slides: true`（常配合 `layout: slides`）+ HR 边界
表面	Web Device slides / document embed player
公共状态	`released`
Fallback / 失败	无 flag → 普通分隔；无 widget → 仅 transcript
验证	下方路由 · demo 页 · `arc --version` = `2.0.0-beta.28`

Sample

在内容记录上编写 front matter：

---
title: A short technical explanation
slides: true
layout: slides
---

## Start with one idea

The first slide is an ordinary Markdown body.

---

## Continue on a new slide

- A list
- a table

本参考页不会把自己变成 deck（它是参考，不是 slides 记录）。live player（当服务 runtime 含 slides widget 时）：Slides demo。

deck 可以再加一个同级 key slidesLayout（side · side-reverse · stacked · stacked-reverse），决定阅读形态中每张 slide 卡片与 note 的排布，默认为 side。在包含 segment 阅读形态的服务 runtime 上，未知值会导致 build 失败。完整板式合同（含窄屏 fallback 与分节页）见 markdown-slides 指南。

配对结构：thematic-break / HR。

失败与限制

情形	预期结果
缺 `slides: true`	普通文章；HR 仅为分隔
有 slides flag 无 widget 挂载	服务端 transcript / 不完整 player chrome
`slidesLayout` 值未知	build 拒绝 deck，并列出有效值
期望自由画布编辑	超出合同

验证证据

项	值
基线	`2026-08-09` · `arc --version` → `2.0.0-beta.28`
能力行	`docs/aup/capability-matrix.md` §6 · `slides: true` front matter · widget `deck`
实现	`slides.ts` · `SLIDES_FRONT_MATTER_FIELD` · `widgets/slides` · `renderer/primitives/deck.ts`
公开路由	`/en/docs/web-device/markdown/slides-front-matter/` · `/zh/docs/web-device/markdown/slides-front-matter/` · demo `/en/docs/web-device/slides-demo/`
本地运行	`arc service start --blocklet blocklets/arcblock --port 4900` · 打开参考 + demo
接受标准	源码展示 flag+HR 合同；demo（若有 widget）可播放；无画布声明

Sample 合同

Sample

失败与限制

验证证据

相关