marp

Files (8)

• SKILL.md
• template.md · assets/
• advanced-features.md · references/
• best-practices.md · references/
• cli.md · references/
• syntax.md · references/
• themes.md · references/
• ensure_marp.sh · scripts/

SKILL.md (first lines)

# Marp Presentations

Create presentations from Markdown using [Marp](https://marp.app).

## Quick Start

1. Create a `.md` file with `marp: true` in front-matter
2. Separate slides with `---`
3. Export with `marp --pdf slides.md` or `npx @marp-team/marp-cli --pdf slides.md`

## Basic Structure

```markdown
---
marp: true
theme: default
paginate: true
---

<!-- _class: lead -->

# Presentation Title

Author Name

---

## Content Slide

- Point one
- Point two
- Point three
```

## Workflow

### Step 1: Understand Requirements

- Identify content: title, topics, key points
- Determine target audience
- Assess formality level

### Step 2: Select Theme

| Content Type | Recommended Theme |
|-------------|-------------------|
| General/Unsure | `default` |
| Modern/Dark | `gaia` with `invert` |
| Minimal/Clean | `uncover` |

### Step 3: Structure Content

1. **Title slide**: Use `<!-- _class: lead -->` + h1
2. **Agenda slide**: Overview with 3-5 items
3. **Content slides**: h2 title + bullet points
4. **Summary slide**: Key takeaways

### Step 4: Apply Best Practices

- **Titles**: 3-5 words, clear and concise
- **Bullets**: 3-5 items per slide
- **Text**: 15-30 characters per line
- **Rule**: 1 slide = 1 message

### Step 5: Add Images (if needed)

Common pattern:
```markdown
## Slide Title

![bg right:40%](image.png)

- Explanation point 1
- Explanation point 2
```

### Step 6: Export

```bash
marp slides.md -o output.pdf    # PDF
marp slides.md -o output.pptx   # PowerPoint
marp slides.md -o output.html   # HTML
```

## Handling "Make It Look Good" Requests

When users give vague instructions like "make it professional" or "improve the design":

1. **Infer from content**:
   - Business content → `default` theme, formal structure
   - Technical content → `gaia` with `invert`, code-friendly
   - Creative content → custom colors via `backgroundColor`

2. **Apply automatically**:
   - Shorten titles to 3-5 words
   - Limit bullet points to 3-5 items
   - Add whitespace between sections
   - Use consistent structure throughout

3. **Enhance visual hierarchy**:
   - Title slide with `<!-- _class: lead -->`
   - Section breaks with centered headings
   - Logical flow: intro → body → conclusion

## Essential Directives

| Directive | Usage |
|-----------|-------|
| `theme` | `default`, `gaia`, `uncover` |
| `paginate` | `true` for page numbers |
| `class` | `lead` (centered), `invert` (dark) |
| `_class` | Single-slide class (prefix `_`) |
| `header` | Header text for all slides |
| `footer` | Footer text for all slides |

## Image Quick Reference

```markdown
![bg](image.jpg)              <!-- Full background -->

From ivanrvpereira/.agents, Apache-2.0.

More from ivanrvpereira/.agents