用途：把主题描述或现有文档转成 MARP（Markdown Presentation Ecosystem）幻灯片，导出为自包含 HTML，并接入 MkDocs Material 站点，发布为可嵌入的在线演示。
主要能力：生成 docs/slides/<deck-slug>/ 目录，包含 slides.md（唯一手改源文件）、slides.html（自包含导出）、可选 slides.pdf、thumbnail.png、metadata.json 和 index.md（含 iframe 嵌入与全屏/下载按钮）；在 docs/slides/index.md 画廊中新增卡片；在 mkdocs.yml 的 Slides 导航节新增条目。
使用方式：先确认输入与范围（幻灯片数量、MARP 主题、落点章节），起草大纲并确认后再写 slides.md；随后在项目根目录运行导出命令： npx --yes @marp-team/marp-cli@latest "$DECK/slides.md" --html -o "$DECK/slides.html" npx --yes @marp-team/marp-cli@latest "$DECK/slides.md" --image png -o "$DECK/thumbnail.png" 如需 PDF 再加 --pdf；引用本地图片时加 --allow-local-files。之后编写 index.md、metadata.json，更新画廊与 mkdocs.yml 导航。
适用场景：为 MkDocs Material 站点制作可嵌入的 MARP 演示，或把章节、README 等文档压缩成幻灯片。
限制：slides.html 与 thumbnail.png 为生成产物，不可手改，改 slides.md 后需重新导出；MARP 为固定 16:9 画布，内容过多会溢出，应拆分幻灯片；压缩文档时被删内容应放入演讲者备注而非丢弃；YAML frontmatter 值中未加引号的冒号会破坏解析；不使用客户端 MARP JS 渲染。预览需用户自行运行 mkdocs serve。