Marp

When to Use This Skill

USE When

• Creating presentations from Markdown content
• Need quick slide creation without design overhead
• Want version-controlled presentations (Git-friendly)
• Require multiple output formats (PDF, HTML, PPTX)
• Building automated presentation pipelines
• Need consistent branding across presentations
• Creating technical presentations with code
• Need math equations in slides

DON'T USE When

• Need complex animations and transitions (use PowerPoint/Keynote)
• Require real-time collaboration (use Google Slides)
• Building interactive web applications (use reveal.js directly)
• Need embedded videos with playback controls
• Building documentation websites (use MkDocs or Docusaurus)

Prerequisites

Installation

# Using npm (recommended)
npm install -g @marp-team/marp-cli

# Using npx (no installation needed)
npx @marp-team/marp-cli --version

# Using Homebrew (macOS)
brew install marp-cli


*See sub-skills for full details.*
### VS Code Extension

```bash
# Install from VS Code marketplace
# Search: "Marp for VS Code"
# Extension ID: marp-team.marp-vscode

code --install-extension marp-team.marp-vscode

Version History

v1.0.0 (2026-01-17)

• Initial skill creation
• Basic slide creation with Markdown
• Theme customization
• Speaker notes and presenter view
• Image and background handling
• Math equations with KaTeX
• Mermaid diagram integration
• CLI usage and configuration
• VS Code extension setup
• GitHub Actions workflow
• Best practices and troubleshooting

Sub-Skills

• 1. Basic Slide Creation
• Integration with npm Project (+1)
• 1. Project Structure (+1)
• PDF Export Fails (+3)

Sub-Skills

• Slide 2: Key Points
• 2. Frontmatter Configuration (+4)
• 7. Images and Backgrounds
• 8. Math Equations
• Inline Math
• 9. Mermaid Diagrams
• Flowchart
• 10. CLI Usage (+5)
• Left Column
• Right Column
• 3. Image Guidelines
• Related Resources