# Marp

> Create professional Markdown-based slide presentations with Marp. Covers themes, directives, speaker notes, presenter view, and export to PDF, HTML, and PPTX formats. Includes VS Code integration, CLI usage, and CI/CD automation.

- Skill: `vamseeachanta/marp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/marp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/marp/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/marp

---


# 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

```bash
# 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](1-basic-slide-creation/SKILL.md)
- [Integration with npm Project (+1)](integration-with-npm-project/SKILL.md)
- [1. Project Structure (+1)](1-project-structure/SKILL.md)
- [PDF Export Fails (+3)](pdf-export-fails/SKILL.md)

## Sub-Skills

- [Slide 2: Key Points](slide-2-key-points/SKILL.md)
- [2. Frontmatter Configuration (+4)](2-frontmatter-configuration/SKILL.md)
- [7. Images and Backgrounds](7-images-and-backgrounds/SKILL.md)
- [8. Math Equations](8-math-equations/SKILL.md)
- [Inline Math](inline-math/SKILL.md)
- [9. Mermaid Diagrams](9-mermaid-diagrams/SKILL.md)
- [Flowchart](flowchart/SKILL.md)
- [10. CLI Usage (+5)](10-cli-usage/SKILL.md)
- [Left Column](left-column/SKILL.md)
- [Right Column](right-column/SKILL.md)
- [3. Image Guidelines](3-image-guidelines/SKILL.md)
- [Related Resources](related-resources/SKILL.md)