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.
Best use case
marp is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using marp should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/marp/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How marp Compares
| Feature / Agent | marp | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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)
Related Skills
baoyu-article-illustrator
Article illustrations: type × style × palette consistency.
vscode-extensions
VS Code productivity optimization with essential extensions, settings sync, profiles, keybindings, snippets, and workspace configuration
git-advanced
Advanced git workflows including rebase, worktrees, bisect, hooks, and monorepo patterns
docker
Complete Docker containerization patterns with multi-stage builds for development and production workflows
elite-frontend-ux
Create distinctive, production-grade frontend interfaces with expert-level UX design. Use when building SaaS dashboards, landing pages, marketing sites, React/Vue components, HTML/CSS layouts, or any web UI. Combines bold aesthetic direction with systematic design tokens, WCAG accessibility, conversion optimization, and Tailwind/React best practices. Produces polished, memorable interfaces that avoid generic AI aesthetics while meeting professional standards. type: reference
sphinx
Generate comprehensive Python documentation with Sphinx. Covers autodoc for API extraction, Napoleon for Google/NumPy docstrings, intersphinx for cross-references, and multiple output formats including HTML, PDF, and ePub.
pandoc
Universal document converter for transforming Markdown to PDF, DOCX, HTML, LaTeX, and 40+ other formats. Covers templates, filters, citations with BibTeX/CSL, and batch conversion automation scripts.
docusaurus
Build modern documentation websites with Docusaurus. Covers docs, blog, pages, versioning, i18n, search integration, and deployment patterns. React-based with MDX support for interactive documentation.
slack-api
Slack bot development and workspace automation using Web API, Events API, Socket Mode, and Block Kit for building interactive messaging applications
miro-api
Miro whiteboard automation using REST API v2 and Python SDK for creating boards, frames, shapes, connectors, and collaborative visual workflows
calendly-api
Calendly scheduling automation using REST API v2 for managing event types, availability, bookings, webhooks, and scheduling workflows
mkdocs
Build professional project documentation with MkDocs and Material theme. Covers site configuration, navigation, plugins, search optimization, versioning with mike, and deployment to GitHub Pages.