用途:把整套演示文稿保存在一个 .md 文件里,其余预览、检查与导出都由 Marp 渲染产生。适用于用户要求 Marp 或版本可控的 Markdown 幻灯、想把 .pptx 重建为 Markdown,或已有一份 Marp 文件需要修改的场景。
主要能力:单一渲染命令配合输出参数完成预览与导出:npx --yes @marp-team/marp-cli <deck.md> --html --allow-local-files <output flags>。--html 让内联 svg 与 HTML 组件正常渲染,--allow-local-files 解析相对图片路径;输出可选逐页 PNG(--images png)、PDF、PPTX、可编辑 PPTX(--pptx --pptx-editable)或 HTML。若找不到浏览器可设置 CHROME_PATH。scripts/preview.sh <dir> 与 scripts/export.sh <deck.md> pdf|pptx|html|all [--editable] 对该命令做了封装。
使用方式:流程分路由与步骤。新做(New)按 1→2→3→4→5 走;含糊低风险需求走 Quick,直接推断并说明简报与预设;导入分支先用 python scripts/extract-pptx.py <input.pptx> <out_dir> 抽出幻灯片与素材,确认后再进入生成;编辑分支读取现有文件,保留其 frontmatter、主题与密度,只改指定页。Step 1 询问用途、长度、内容与密度;Step 2 读 references/themes.md,给出三份真正不同的单页预览并渲染成 PNG 让用户挑选;Step 3 读组件、主题与示例后按大纲整体生成;Step 4 逐页渲染 PNG 检查内容是否超出画布、图表是否真渲染、有无文字融背景或重叠;Step 5 报告文件位置、预设与页数,并提供导出选项。
限制与注意:Marp 会静默裁剪溢出内容,需依赖逐页 PNG 检查;PPTX 默认为每页一张图、文字不可编辑,--pptx-editable 需要 LibreOffice 且与 CSS 保真度较低;LibreOffice 24.2+ 移除 Impress HTML 导入过滤器后,可用 officecli 方式生成可编辑 PPTX,其保真度有意低于 Marp 渲染(HTML 组件与 SVG 图表变为占位文本),应把 PDF/HTML 视为视觉母版。HTML 是唯一保留动画、details 与 * 片段揭示的格式。资料未提供收费与价格信息。