Marp CLI

通过命令行将 Markdown 转换为演示文稿。支持输出 HTML、PDF、PowerPoint（PPTX）以及图片（PNG/JPEG）格式。

浏览器要求：标有 🌐 的转换操作需要系统中已安装兼容的浏览器（Chrome、Edge 或 Firefox）。

快速开始

# 转换为 HTML
marp slide-deck.md

# 转换为 PDF（需浏览器）
marp --pdf slide-deck.md

# 转换为 PowerPoint
marp --pptx slide-deck.md

# 转换为图片
marp --images png slide-deck.md

📖 详细指南： QUICKSTART.md

格式转换

HTML

marp slide-deck.md
marp slide-deck.md -o output.html

PDF 🌐

marp --pdf slide-deck.md
marp slide-deck.md -o output.pdf

# 启用 PDF 大纲（书签）
marp --pdf --pdf-outlines slide-deck.md

# 将演讲者备注作为左下角注释添加到 PDF 中
marp --pdf --pdf-notes slide-deck.md

PowerPoint（PPTX）🌐

marp --pptx slide-deck.md
marp slide-deck.md -o output.pptx

# 生成可编辑的 PPTX（实验性功能，需 LibreOffice Impress）
marp --pptx --pptx-editable slide-deck.md

图片 🌐

# 生成多张幻灯片图片
marp --images png slide-deck.md
marp --images jpeg slide-deck.md

# 仅导出标题页图片
marp --image png slide-deck.md
marp slide-deck.md -o output.png

# 高分辨率输出（指定缩放因子）
marp slide-deck.md -o title.png --image-scale 2

演讲者备注

marp --notes slide-deck.md
marp slide-deck.md -o output.txt

监听模式（Watch mode）

# 监听文件变更并自动转换
marp -w slide-deck.md

# 监听并同时打开浏览器预览
marp -w -p slide-deck.md

服务器模式（Server mode）

# 启动服务，按需转换指定目录下的文件
marp -s ./slides

# 通过环境变量指定端口
PORT=5000 marp -s ./slides

# 通过 URL 查询参数访问不同格式的转换结果
# http://localhost:8080/deck.md?pdf
# http://localhost:8080/deck.md?pptx

预览窗口（Preview window）

# 打开本地预览窗口（自动启用监听模式）
marp -p slide-deck.md

# 预览时直接输出 PDF
marp -p --pdf slide-deck.md

多文件处理

# 批量转换多个文件
marp slide1.md slide2.md slide3.md

# 转换整个目录
marp ./slides/

# 使用 glob 模式匹配
marp **/*.md

# 并行转换（默认并发数为 5）
marp -P 10 ./*.md

# 禁用并行转换
marp --no-parallel ./*.md

选项说明

常用场景示例

# 编辑过程中实时监听并预览
marp -w -p deck.md

# 为 slides 目录启动服务
marp -s ./presentations

# 将所有 Markdown 幻灯片批量转为 PDF
marp --pdf *.md

# 基于标题页生成 Open Graph 图片（高倍率）
marp deck.md -o og.png --image-scale 3

# 导出演讲者备注文本
marp --notes deck.md

文档资源