Home
cd ../playbooks
Creative & DesignBeginner

Markdown to Slides Converter

Convert Markdown files into professional presentations exportable to PDF, PPTX, or HTML using Marp.

10 minutes
By communitySource
#markdown#slides#marp

You spent three hours in PowerPoint nudging text boxes and fixing bullet alignment instead of working on your actual content. Your talk is tomorrow and you're still on slide 12 of 30. Meanwhile, developers ship beautiful slide decks from plain text in minutes.

Who it's for: developers who present at meetups and conferences, technical writers creating documentation presentations, educators building lecture slides from notes, startup founders creating investor pitch decks quickly, engineers who hate PowerPoint but need professional slides

Example

"Convert my talk outline into a slide deck" → 30-slide Marp presentation with consistent theming, code syntax highlighting, speaker notes, exported as PDF and HTML, with a live-preview workflow for iterating on content

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Markdown Slides

## Overview

This workflow enables creation of presentations from pure Markdown using **Marp**. Write slides in familiar Markdown syntax and export to PDF, PPTX, or HTML with professional themes.

## How to Use

1. Write or provide Markdown content
2. I'll format it for Marp with proper directives
3. Export to your preferred format (PDF/PPTX/HTML)

**Example prompts:**
- "Convert my notes to a presentation"
- "Create slides from this markdown"
- "Build a pitch deck using markdown"
- "Generate PDF slides from this outline"

## Domain Knowledge

### Basic Syntax

```markdown
---
marp: true
---

# First Slide

Content here

---

# Second Slide

- Bullet 1
- Bullet 2
```

### Themes

```markdown
---
marp: true
theme: default  # default, gaia, uncover
---
```

### Directives

```markdown
---
marp: true
theme: gaia
class: lead        # Centered title
paginate: true     # Page numbers
header: 'Header'   # Header text
footer: 'Footer'   # Footer text
backgroundColor: #fff
---
```

### Images

```markdown
![width:500px](image.png)
![bg](background.jpg)
![bg left:40%](sidebar.jpg)
```

### Columns

```markdown
<div class="columns">
<div>

## Left

Content

</div>
<div>

## Right

Content

</div>
</div>
```

## Example

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

<!-- _class: lead -->

# Project Update

Q4 2024 Review

---

# Highlights

- Revenue: +25%
- Users: +50%
- NPS: 72

---

# Roadmap

| Q1 | Q2 | Q3 | Q4 |
|----|----|----|-----|
| MVP | Beta | Launch | Scale |

---

<!-- _class: lead -->

# Thank You!

questions@company.com
```

## CLI Usage

```bash
# Install
npm install -g @marp-team/marp-cli

# Convert
marp slides.md -o presentation.pdf
marp slides.md -o presentation.pptx
marp slides.md -o presentation.html
```

## Resources

- [Marp Documentation](https://marp.app/)
- [GitHub](https://github.com/marp-team/marp)

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

This workflow enables creation of presentations from pure Markdown using Marp. Write slides in familiar Markdown syntax and export to PDF, PPTX, or HTML with professional themes.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/Documents/MdSlides

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ~/Documents/MdSlides/

Step 3: Start Working

cd ~/Documents/MdSlides
claude

How to Use

  1. Write or provide Markdown content
  2. I'll format it for Marp with proper directives
  3. Export to your preferred format (PDF/PPTX/HTML)

Example prompts:

  • "Convert my notes to a presentation"
  • "Create slides from this markdown"
  • "Build a pitch deck using markdown"
  • "Generate PDF slides from this outline"

Examples

---
marp: true
theme: gaia
paginate: true
---

<!-- _class: lead -->

# Project Update

Q4 2024 Review

---

# Highlights

- Revenue: +25%
- Users: +50%
- NPS: 72

---

# Roadmap

| Q1 | Q2 | Q3 | Q4 |
|----|----|----|-----|
| MVP | Beta | Launch | Scale |

---

<!-- _class: lead -->

# Thank You!

questions@company.com

$Related Playbooks

Creative & Design

Theme Factory

Apply professional themes to presentations, documents, and landing pages with 10 pre-set themes plus custom theme generation.

5 minutes
Beginner
Creative & Design

PPT Creator

Create professional slide decks from topics or documents — structured content with data-driven charts, speaker notes, and complete PPTX files, applying the Pyramid Principle and assertion-evidence storytelling.

15 minutes
Intermediate
Creative & Design

Presentation Visual Designer

Design presentation visuals and slide layouts. Create visual concepts, suggest graphics, and provide design specifications for impactful PowerPoint slides.

10 minutes
Intermediate
Creative & Design

PowerPoint Manipulation Tool

Programmatically create and edit PowerPoint presentations with text, shapes, charts, and tables.

10 minutes
Advanced
Creative & Design

Remotion Video Creator

Create motion videos with Claude Code + Remotion + browser automation. Describe what you want, see live previews, iterate in real-time.

20 minutes
Advanced
Creative & Design

Scientific Docx

'Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like ta...

5 minutes
Beginner
Creative & Design

Scientific Generate Image

Generate or edit images using AI models (FLUX, Nano Banana 2). Use for general-purpose image generation including photos, illustrations, artwork, visual assets, concept art, and any image that is not a technical diagram or schematic. For flowchart...

5 minutes
Beginner
Creative & Design

Scientific Latex Posters

'Create professional research posters in LaTeX using beamerposter, tikzposter, or baposter. Support for conference presentations, academic posters, and scientific communication. Includes layout design, color schemes, multi-column formats, figure i...

10 minutes
Intermediate
Creative & Design

Structured Design Critique System

A persistent, multi-round design critique pipeline: scope which of 19 design areas your project actually needs, generate real HTML wireframe options for each, collect Keep/Cut feedback, and let locked decisions constrain everything downstream.

15 minutes
Advanced
Creative & Design

Narrative Slide Creator

Narrative-first slide deck creation — design a structured narrative (the ABCDEFG model) first, then generate the visuals, so the story drives the design rather than the other way around.

15 minutes
Intermediate
Creative & Design

Scientific Markdown Mermaid Writing

Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + merma...

5 minutes
Beginner
Creative & Design

Scientific Markitdown

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

5 minutes
Beginner

Browse all Creative & Design playbooks →