Agent Skills
返回列表
📁

Marp 演示文稿生成器

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/marp-cli-markdown-presentation-converter，将 Marp 演示文稿生成能力接入你的 AI 助手。

技能介绍

当 Markdown 成为幻灯片的源码

很多工程师更习惯用 Markdown 写文档，但一涉及演示文稿，就不得不打开 PowerPoint 或 Keynote，用图形界面拖拽文本框、调整主题。这种割裂的工作流让代码审查、版本控制变得困难：你的幻灯片无法像 slide.md 一样被 git diff，也很难复用主题和组件。

Marp CLI 试图把演示文稿拉回“文本即媒介”的轨道。

它如何工作

这个技能基于 Marp CLI，将单个 Markdown 文件编译为静态产物。其核心能力包括：

  • 多格式输出：通过 --pdf 等选项或 -o 指定输出文件，生成 HTML、PDF、PPTX 或图像（PNG/JPEG）。HTML 适合 Web 嵌入，PDF 便于归档，PPTX 则为了兼容传统放映场景。
  • 主题与指令驱动：Markdown 文件顶部通过 marp: true 启用 Marp，再用 theme、paginate、backgroundColor 等 front-matter 指令控制全局外观；使用 --- 分隔符划分幻灯片页。
  • 无侵入式转换：原生 Markdown 语法（标题、列表、代码块）被保留并渲染，只需在需要时添加 marp 专有语法（如 <!-- _class: lead -->）。

关键步骤：编写含 Marp 指令的 .md 文件 → 用 CLI 执行转换 → 分发生成的静态文件。

适用边界与注意点

  • 该工具依赖 Node.js v18+ 运行环境；若不想在本地安装 Node 和 Chrome，可使用官方 Docker 容器 marpteam/marp-cli。
  • PPTX 输出在复杂排版、自定义动画方面仍有限制，它更侧重“内容结构化”而非“视觉炫技”。
  • 转换过程是单向的：生成的 output.pdf 不会自动回链到源 Markdown，你需要自己管理文件关联。

使用场景

  • 技术团队在评审会上需要把架构说明 Markdown 直接转成 PDF 幻灯片，避免在 PowerPoint 里重复排版。
  • 开源作者维护一份 Markdown 教程，希望用同一套源码生成网页版幻灯片和可离线分享的 HTML 文件。
  • 培训讲师写好 Markdown 大纲，需要批量导出 PPTX 发给学员，同时保留一份可在浏览器演示的 HTML。
  • 开发文档包含大量代码示例，需要把 Markdown 变成带主题的幻灯片，确保代码块和分页在演示中正常显示。

适合人员

  • 需要在评审会上快速产出演示材料的后端工程师，诉求是复用已有 Markdown 文档减少排版时间。
  • 维护技术教程并希望一份源码多端输出的开源作者，诉求是统一网页与幻灯片的视觉风格。
  • 经常组织内部培训并需要分发讲义的技术讲师，诉求是用 Markdown 生成可放映且可打印的 PPTX。
  • 负责撰写长篇技术文档并偶尔做分享的 DevOps 工程师，诉求是把文档片段快速变成结构化幻灯片。