用途:用纯 Markdown 编写 MARP 幻灯片(Marpit + Marp Core + marp-cli),导出为 PDF、PowerPoint 或自包含 HTML。每份演示是单个 .md 文件,便于纳入 git 并用 CSS 定制主题。
触发场景:用户点名要 MARP 演示、要“markdown 幻灯片”、要可提交 git 且可确定性重新生成的 .md、提到 marp-cli 或 Marpit 指令、要用 CSS 定制主题,或要从文本导出 PDF/PPTX。不适用:Reveal.js 类浏览器原生演示、编辑二进制 .pptx 原生动画、静态海报、Manim 动画视频。
主要能力:YAML frontmatter 设置 theme、paginate、header、footer 与全局 style;用 --- 分页;<!-- _class: lead --> 居中标题页,<!-- _paginate: skip --> 隐藏页码;背景图支持 、、 等扩展语法,多张 ![bg] 横向排列,加 vertical 变列布局。按需加载参考文件:DIRECTIVES.md(指令与 frontmatter)、THEMES.md(dark-dashboard、light-editorial 起始 CSS)、COMPONENTS.md(SVG 图表、卡片、状态标签)、EXPORT.md(marp-cli 参数、Chrome 依赖、--html)、examples/(dashboard、editorial、technical 三份示例)。
使用方式:先确认导出目标(默认 pdf)、主题(默认 dark-dashboard)、比例(默认 16:9)、页数、视觉密度、品牌信息,未指定则静默用默认值。导出最小命令:npx @marp-team/marp-cli@latest slides.md --pdf --allow-local-files --html。
限制与注意:MARP 对溢出内容静默裁切,无警告,故每页只讲一个想法,列表最多 6 行;图片只用相对路径,绝对路径会破坏 VS Code 预览与 PDF 导出;使用 SVG、div、details 或内联样式时必须加 --html,否则 HTML 标签会被转义为文本;主题 CSS 应写在全局 style 指令或单独 .css 中,不要逐页硬编码。该技能封装 MIT 许可的 MARP 生态。具体收费、价格与平台支持资料暂未提供。