Linux command
marp 命令
文本
复制后可按需替换文件名、目录或参数。
常用示例
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]
说明
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.
参数
- -o, --output _file_
- Output filename or directory.
- 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.
FAQ
What is the marp command used for?
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.
How do I run a basic marp example?
Run `marp [slides.md] -o [slides.html]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does -o, --output _file_ do in marp?
Output filename or directory.