marp-cli

📽️ Markdown 秒变专业演示文稿

办公榜 #45

源自 marp-team 开源社区的官方 CLI 文档,让开发者用 Markdown 语法极速生成 PDF、PPTX 等格式的专业演示文稿,提升技术分享效率。

收藏
11.8k
安装
3.2k
版本
v0.0.1
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

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,避免使用来路不明的二进制包。

安全解读

核心用法

Marp CLI Skill 是一份详尽的命令行工具使用指南,帮助用户通过 Markdown 快速生成专业演示文稿。核心功能包括:

格式转换:支持 HTML(默认)、PDF、PowerPoint (PPTX)、PNG/JPEG 图片四种输出格式。PDF 和 PPTX 转换需本地安装 Chrome/Edge/Firefox 浏览器。

实时开发:提供 Watch 模式(-w)自动监听文件变更并重编译,结合 Preview 模式(-p)可在浏览器中实时预览效果。

服务器模式:通过 marp -s 启动本地服务,支持通过 URL 参数(如 ?pdf)按需转换,便于团队协作和在线分享。

批量处理:支持多文件、目录遍历、Glob 模式匹配,并可配置并行度(-P)加速大规模转换。

显著优点

1. 纯文档零风险:本 Skill 仅为 Markdown 文档集合,无可执行代码、无第三方依赖、无网络请求,通过 S+ 级安全认证。
2. 来源权威可信:源自 marp-team 官方开源项目(GitHub 高星活跃社区),MIT 许可证,T1 级别可信来源。

3. 格式覆盖全面:一份 Markdown 源文件可导出为网页、印刷级 PDF、可编辑 PPT、高清图片,满足多元场景。

4. 开发者友好:CLI 设计符合 Unix 哲学,管道友好,易于集成到 CI/CD 和自动化工作流。

潜在局限

  • 浏览器依赖:PDF/PPTX/图片转换需预装 Chromium 内核浏览器,纯服务器环境配置较复杂。
  • PPTX 可编辑性有限--pptx-editable 为实验性功能,依赖 LibreOffice Impress,复杂排版可能丢失。
  • 本地文件限制:默认沙箱策略禁止访问本地资源,需显式开启 --allow-local-files,存在一定安全风险。
  • 图片精度瓶颈:超高分辨率输出依赖 --image-scale 参数,但过大倍数会显著增加内存占用。

适合人群

  • 技术布道者、开发者 advocate、开源社区讲师
  • 追求「文档即幻灯片」效率的极简主义者
  • 需要将 Markdown 内容快速分发为多格式载体的内容团队
  • 对工具链安全性要求苛刻的企业环境

常规风险

本 Skill 本身无任何代码执行风险。实际使用 Marp CLI 工具时需注意:

  • --allow-local-files 会放宽同源策略,仅在可信文件路径下使用
  • 浏览器渲染进程可能消耗较多内存,超大幻灯片建议分册处理

marp-cli 内容

手动下载zip · 10.6 kB
EXAMPLES.mdtext/markdown
请选择文件