marp
creates presentations from Markdown
TLDR
Convert to HTML
$ marp [slides.md] -o [slides.html]
Convert to PDF$ marp [slides.md] --pdf -o [slides.pdf]
Convert to PPTX$ marp [slides.md] --pptx -o [slides.pptx]
Convert slides to images$ marp [slides.md] --images [png] -o [slides/]
Preview with live reload$ marp -p [slides.md]
Use custom theme$ marp --theme [theme.css] [slides.md] -o [output.html]
Start server mode$ marp -s [slides/]
Watch for changes and auto-convert$ marp -w [slides.md] -o [slides.html]
SYNOPSIS
marp [options] file
DESCRIPTION
Marp (Markdown Presentation Ecosystem) creates presentations from Markdown. It converts specially formatted Markdown into slides in HTML, PDF, or PowerPoint formats.Slides are separated by --- and support custom themes, speaker notes, and directives.
PARAMETERS
-o, --output file
Output filename or directory.--pdf
Export as PDF.--pptx
Export as PowerPoint.--images [png|jpeg]
Export slides as multiple image files.--image [png|jpeg]
Export the first slide as a single image.--notes
Export presenter notes as a text file.-p, --preview
Open preview window.-s, --server dir
Start server mode for on-demand conversion.--theme css
Custom theme CSS file.-w, --watch
Watch for file changes and auto-convert.--pdf-notes
Add presenter notes as PDF annotations.--pdf-outlines
Add bookmarks to PDF output.--allow-local-files
Allow access to local files during conversion.--image-scale factor
Scale factor for rendered images (default: 1).-I, --input-dir dir
Base directory for input with output directory preservation.-c, --config-file file
Path to configuration file.--engine module
Specify Marpit-based conversion engine.
SLIDE FORMAT
$ ---
marp: true
theme: default
---
# Slide 1
Content here
---
# Slide 2
More content
marp: true
theme: default
---
# Slide 1
Content here
---
# Slide 2
More content
CAVEATS
PDF and image export require Chrome, Edge, or Firefox. Some CSS features are limited in PPTX output. Local file references require --allow-local-files for PDF/image conversion.
HISTORY
Marp was created by Yuki Hattori (yhatt) in 2016 as Marp desktop app, later rewritten as Marp Next ecosystem with CLI.
SEE ALSO
pandoc(1)
