Marp Slide

Marp Slide Creator

Create professional, visually appealing Marp presentation slides with 7 pre-designed themes and built-in best practices.

When to Use This Skill

Use this skill when the user:

Quick Start

Step 1: Select Theme

First, determine the appropriate theme based on the user's request and content.

Quick theme selection:

For detailed theme selection guidance, read references/theme-selection.md.

Step 2: Create Slides

- Always start by reading references/marp-syntax.md for basic syntax

- For images: references/image-patterns.md (official Marpit image syntax)

- For advanced features (math, emoji): references/advanced-features.md

- For custom themes: references/theme-css-guide.md

- assets/template-basic.md - Default theme (most common)

- assets/template-minimal.md - Minimal theme

- assets/template-colorful.md - Colorful theme

- assets/template-dark.md - Dark mode theme

- assets/template-gradient.md - Gradient theme

- assets/template-tech.md - Tech/code theme

- assets/template-business.md - Business theme

- Title slide with <!-- _class: lead -->

- Concise h2 titles (5-7 characters in Japanese)

- 3-5 bullet points per slide

- Adequate whitespace

Available Themes

1. Default Theme

Colors: Beige background, navy text, blue headings

Style: Clean, sophisticated with decorative lines

Use for: General seminars, lectures, presentations

Template: template-basic.md

2. Minimal Theme

Colors: White background, gray text, black headings

Style: Minimal decoration, wide margins, light fonts

Use for: Content-focused presentations, academic talks

Template: template-minimal.md

3. Colorful & Pop Theme

Colors: Pink gradient background, multi-color accents

Style: Vibrant gradients, bold fonts, rainbow accents

Use for: Youth-oriented events, creative projects

Template: template-colorful.md

4. Dark Mode Theme

Colors: Black background, cyan/purple accents

Style: Dark theme with glow effects, eye-friendly

Use for: Tech presentations, evening talks, modern look

Template: template-dark.md

5. Gradient Background Theme

Colors: Purple/pink/blue/green gradients (varies per slide)

Style: Different gradient per slide, white text, shadows

Use for: Visual-focused, creative presentations

Template: template-gradient.md

6. Tech/Code Theme

Colors: GitHub-style dark background, blue/green accents

Style: Code fonts, Markdown-style headers with # symbols

Use for: Programming tutorials, tech meetups, developer content

Template: template-tech.md

7. Business Theme

Colors: White background, navy headings, blue accents

Style: Corporate presentation style, top border, table support

Use for: Business presentations, proposals, reports

Template: template-business.md

Creating Slides Process

Basic Workflow

- Identify content: title, topics, key points

- Determine target audience

- Assess formality level

- Use quick selection rules above

- If uncertain, consult references/theme-selection.md

- Default to default theme if still unsure

- Load appropriate template from assets/

- CSS is already embedded - no external files needed

- Maintain template structure

- Title slide: <!-- _class: lead --> + h1

- Content slides: h2 title + bullet points

- Keep titles to 5-7 characters (Japanese)

- Use 3-5 bullet points per slide

- Read references/best-practices.md

- Ensure adequate whitespace

- Maintain consistency

- Keep text concise (15-25 chars per line)

- If needed, consult references/image-patterns.md

- Common: ![bg right:40%](image.png) for side images

- Use proper Marp image syntax

- Save to the project output directory

- Use descriptive filename like presentation.md

Handling "Make It Look Good" Requests

When users give vague instructions like "良い感じにして", "かっこよく", or "make it cool":

- Business content → business theme

- Technical content → tech or dark theme

- Creative content → gradient or colorful theme

- General → default theme

- Shorten titles to 5-7 characters

- Limit bullet points to 3-5 items

- Add adequate whitespace

- Use consistent structure

- Use h3 for sub-sections when appropriate

- Break up dense text into multiple slides

- Ensure logical flow (intro → body → conclusion)

- Match formality to content

- Use parallel structure in lists

- Keep technical terms consistent

Image Integration

For slides with images, consult references/image-patterns.md for detailed syntax.

Common patterns:

Example lecture pattern:

## Slide Title


- Explanation point 1
- Explanation point 2
- Explanation point 3

File Output

Always save the final Marp file to the project output directory with .md extension:

Quality Checklist

Before delivering slides, verify:

References

Core Documentation

Quality & Selection Guides

Templates & Assets

Official External Links