marp-cli

Marp CLI 是 marp-team 开源社区推出的专业级 Markdown 演示文稿转换工具，专为技术从业者设计。该技能文档详细指导用户如何通过命令行将纯 Markdown 文本一键转换为 HTML、PDF、PowerPoint (PPTX) 及高清图片等多种演示格式，彻底打破传统幻灯片制作的技术壁垒。

核心用法围绕格式转换展开。基础命令 marp slide-deck.md 可直接生成 HTML 预览；追加 --pdf 或 --pptx 参数即可导出通用商务格式；通过 --images png 能将各页转为独立图片，方便社交媒体分享。Watch 模式 (-w) 支持文件变更自动重编译，配合 Preview 模式 (-p) 实现"保存即刷新"的实时预览体验。Server 模式 (-s) 则允许将整个目录作为幻灯片服务器运行，通过 URL 参数动态切换输出格式，非常适合团队协作场景。对于批量处理，工具支持 glob 模式匹配与并行转换 (-P)，可一次性处理数十个 Markdown 文件。

显著优点体现在开发友好性上。首先，它延续了 Markdown 的简洁语法，让开发者无需学习复杂的 GUI 操作，用熟悉的文本编辑器就能制作幻灯片。其次，输出质量专业，生成的 PDF 保留矢量图形与超链接，PPTX 格式可直接在 Office 中二次编辑（实验性功能）。再者，开源生态完善，基于 MIT 协议，社区提供了丰富的主题与插件支持。实时预览与自动刷新机制大幅提升了迭代效率，特别适合需要频繁调整的技术演讲准备。

潜在局限性不容忽视。PDF 与 PPTX 转换依赖本地安装的 Chrome、Edge 或 Firefox 浏览器，无头浏览器环境需额外配置。PPTX 的可编辑模式仍处于实验阶段，复杂排版可能出现兼容性问题。此外，工具基于 Node.js 运行，Windows 环境配置可能相对复杂。对于非技术用户，命令行操作存在一定学习门槛。

该技能主要适合软件开发者、技术布道师、学术研究者及 DevOps 工程师。任何需要用代码方式管理幻灯片版本、追求"文档即演示"理念的技术从业者都会受益。教育领域的讲师也可利用它快速将教案转为课件。

使用风险方面，需注意 --allow-local-files 参数会放开本地文件系统访问权限，处理不受信任的 Markdown 文件时可能带来安全风险，建议仅在隔离环境使用。浏览器自动化转换可能消耗较多内存资源，批量转换大量文件时建议控制并行度 (--no-parallel)。此外，确保从 npm 官方源或 GitHub Release 安装 marp CLI，避免使用来路不明的二进制包。