marp

Convert Markdown with Mermaid diagrams into slide decks via Marp.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/shekerkamma/markdown-viewer-skills-audit --skill marp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marp
Source: https://github.com/shekerkamma/markdown-viewer-skills-audit/tree/main/marp
Command: npx skills add https://github.com/shekerkamma/markdown-viewer-skills-audit --skill marp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown content is great for notes but lacks a straightforward path to presentation decks; Marp bridges this gap by turning Markdown into a deck with slide semantics, YAML frontmatter, and export options.

Core Features & Use Cases

  • Markdown-based slide authoring with YAML frontmatter
  • Mermaid diagram support and embedded HTML for rich visuals
  • Export targets include PPTX, PDF, and HTML for distribution
  • Best for engineering presentations, architecture reviews, and recurring decks regenerated from data

Quick Start

Add YAML frontmatter marp: true, separate slides with ---, and run the Marp CLI to export PPTX, PDF, or HTML.

Frequently Asked Questions about marp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to presentation slides?

Markdown converts to presentation slides by adding YAML frontmatter with marp: true, separating slides with ---, and running the Marp CLI to export decks. This approach bridges Markdown notes and slide semantics.

Can I export Markdown slides to PPTX and PDF?

Yes, Markdown slides export to PPTX, PDF, and HTML formats using the Marp CLI. These export targets support distributing engineering presentations and architecture reviews across different viewing platforms.

Does Marp support Mermaid diagrams in slide decks?

Yes, Marp supports Mermaid diagrams and embedded HTML for rich visuals in slide decks. Combining Markdown with Mermaid diagrams enables detailed architecture reviews and engineering presentations directly from text.

What is the best way to build recurring data-driven presentations?

Building recurring data-driven presentations is best handled by converting Markdown into Marp slide decks. By combining Markdown with Mermaid diagrams and YAML frontmatter, you can regenerate decks from updated data with minimal setup.

Do I need YAML frontmatter to customize individual slides?

Yes, you need YAML frontmatter to enable Marp and customize individual slides. Slide-level customization is achieved through frontmatter directives and slide separators, requiring minimal setup to apply themes and layouts.