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)
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

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

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

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
Creative & Design

Scientific Paper 2 Web

This skill should be used when converting academic papers into promotional and presentation formats including interactive websites (Paper2Web), presentation videos (Paper2Video), and conference posters (Paper2Poster). Use this skill for tasks invo...

10 minutes
Intermediate
Creative & Design

Scientific Pdf

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDF...

5 minutes
Beginner
Creative & Design

Scientific Pptx Posters

Create research posters using HTML/CSS that can be exported to PDF or PPTX. Use this skill ONLY when the user explicitly requests PowerPoint/PPTX poster format. For standard research posters, use latex-posters instead. This skill provides modern w...

10 minutes
Intermediate
Creative & Design

Scientific Pptx

'Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content w...

5 minutes
Beginner
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 Scientific Slides

Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design templat...

10 minutes
Intermediate

Browse all Creative & Design playbooks →