Marp CLI

Convert Markdown to presentations via CLI. Output HTML, PDF, PowerPoint (PPTX), and images (PNG/JPEG).

Browser requirement: Conversions marked with 🌐 require a compatible browser (Chrome, Edge, or Firefox) installed on your system.

Quick Start

# Convert to HTML
marp slide-deck.md

# Convert to PDF (requires browser)
marp --pdf slide-deck.md

# Convert to PowerPoint
marp --pptx slide-deck.md

# Convert to images
marp --images png slide-deck.md

📖 Detailed guide: QUICKSTART.md

Format conversion

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

# With PDF outlines
marp --pdf --pdf-outlines slide-deck.md

# Includes presenter notes as annotations on lower-left
marp --pdf --pdf-notes slide-deck.md

PowerPoint (PPTX) 🌐

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

# Editable PPTX (experimental, requires LibreOffice Impress)
marp --pptx --pptx-editable slide-deck.md

Images 🌐

# Multiple images
marp --images png slide-deck.md
marp --images jpeg slide-deck.md

# Title slide image only
marp --image png slide-deck.md
marp slide-deck.md -o output.png

# High resolution (scale factor)
marp slide-deck.md -o title.png --image-scale 2

Presenter notes

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

Watch mode

# Watch file and auto-convert on changes
marp -w slide-deck.md

# Watch with browser preview
marp -w -p slide-deck.md

Server mode

# Serve directory with on-demand conversion
marp -s ./slides

# Specify port via environment
PORT=5000 marp -s ./slides

# Access converted formats via query strings
# http://localhost:8080/deck.md?pdf
# http://localhost:8080/deck.md?pptx

Preview window

# Open preview window (automatically enables watch mode)
marp -p slide-deck.md

# Preview with PDF output
marp -p --pdf slide-deck.md

Multiple files

# Convert multiple files
marp slide1.md slide2.md slide3.md

# Convert directory
marp ./slides/

# Use glob patterns
marp **/*.md

# Convert with parallelism (default: 5 concurrent)
marp -P 10 ./*.md

# Disable parallelism
marp --no-parallel ./*.md

Options

| Option | Description |

|--------|-------------|

| -o, --output | Output file path |

| -w, --watch | Watch mode - auto-convert on changes |

| -s, --server

# Watch and preview while editing
marp -w -p deck.md

# Serve slides directory
marp -s ./presentations

# Convert all slides to PDF
marp --pdf *.md

# Create OG image from title
marp deck.md -o og.png --image-scale 3

# Export presenter notes
marp --notes deck.md