marp-team/marp-cli

这是什么？

核心功能

• 01将 Markdown 幻灯片转换为 HTML、PDF、PPTX 以及 PNG/JPEG 图片。
• 02watch 模式在文件变化时重新生成并自动刷新浏览器。
• 03server 模式通过 HTTP 按需转换幻灯片。
• 04提供预览窗口和支持键盘导航的 bespoke HTML 模板。
• 05支持导出演讲者备注和 PDF 书签。
• 06可通过命令行参数、配置文件或 Node.js API 进行配置。

适用场景

• 用 Markdown 编写技术分享并导出 PDF 讲义。
• 为使用 Office 的同事从 Markdown 生成 PowerPoint 文件。
• 在 CI 或文档流水线中通过 Docker 自动构建幻灯片。
• 从幻灯片的标题页生成 Open Graph 图片。

快速上手

1. 1

   安装 Node.js v18 或更高版本

2. 2

   使用 npx 将幻灯片转换为 HTML

   npx @marp-team/marp-cli@latest slide-deck.md
3. 3

   将幻灯片转换为 PDF（需要 Chrome、Edge 或 Firefox）

   npx @marp-team/marp-cli@latest slide-deck.md --pdf

使用前须知

• !转换为 PDF、PPTX 和图片需要安装 Google Chrome、Microsoft Edge 或 Mozilla Firefox。
• !实验性的 --pptx-editable 选项还需要安装 LibreOffice Impress，且幻灯片还原度较低。

收录于专题

标签

常见问题

marp-cli 是什么？

将 Marp 和 Marpit Markdown 幻灯片转换为 HTML、PDF、PPTX 与图片的命令行工具。 Marp CLI 是 Marp 以及基于 Marpit 框架的幻灯片转换器的命令行工具。它可以把 Marp 语法的 Markdown 文件转换为静态 HTML 和 CSS、PDF、PowerPoint（PPTX）以及 PNG 或 JPEG 图片。转换为 PDF、PPTX 和图片时需要本机安装 Chrome、Edge 或 Firefox 浏览器。

marp-cli 可以免费使用吗？用的什么许可证？

marp-cli 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

marp-cli 还在维护吗？

半年内有更新。marp-cli 最近一次提交是在 2026年9月8日。

marp-cli 适合用来做什么？

用 Markdown 编写技术分享并导出 PDF 讲义。 为使用 Office 的同事从 Markdown 生成 PowerPoint 文件。 在 CI 或文档流水线中通过 Docker 自动构建幻灯片。 从幻灯片的标题页生成 Open Graph 图片。

marp-cli 怎么安装和运行？

安装 Node.js v18 或更高版本 使用 npx 将幻灯片转换为 HTML: npx @marp-team/marp-cli@latest slide-deck.md 将幻灯片转换为 PDF（需要 Chrome、Edge 或 Firefox）: npx @marp-team/marp-cli@latest slide-deck.md --pdf

在哪里获取 marp-cli？

源代码和安装说明在 GitHub 上：https://github.com/marp-team/marp-cli