Marp Presentation

Convert Markdown to presentation slides (PDF/PPTX)

Overview

Marp is a presentation tool that converts Markdown to beautiful presentations. It supports multiple output formats including PDF and PowerPoint (.pptx) files. It provides a standardized, theme-based approach with support for math typesetting and emoji rendering.

Runs in E2B sandbox environment, so you don’t need to install Marp CLI locally. The conversion process is executed securely in an isolated environment with Node.js, Chromium, and LibreOffice pre-installed.

Key Features

MARP_CONVERT

• Convert Markdown to presentation PDF or PowerPoint
• Runs securely in E2B sandbox environment - no local installation required
• Three built-in themes: default, gaia, uncover
• Multiple output formats: PDF, PPTX, editable PPTX
• Math typesetting support (MathJax/KaTeX)
• Emoji rendering with Twemoji
• Clean, professional slide output
• Returns a signed URL for downloading the generated file

Authentication

No authentication required for Marp tools.

Example: Basic PDF Presentation

- id: create_pdf_presentation
  name: create_pdf_presentation
  tool: MARP_CONVERT
  input:
    - name: markdown
      value: |
        ---
        marp: true
        ---

        # Welcome to Marp

        Create beautiful presentations with Markdown

        ---

        ## Features

        - Simple Markdown syntax
        - Multiple themes
        - Math support
        - Emoji rendering 🎉

        ---

        ## Thank You!
    - name: outputFormat
      value: "pdf"

# Result: {{steps.create_pdf_presentation.result}}
# A signed URL to download the PDF file

Example: PowerPoint with Editable Format

- id: create_editable_pptx
  name: create_editable_pptx
  tool: MARP_CONVERT
  input:
    - name: markdown
      value: |
        ---
        marp: true
        theme: gaia
        ---

        # Mathematics Presentation

        Equations and formulas in slides

        ---

        ## Quadratic Formula

        The quadratic formula is:

        $$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

        ---

        ## Inline Math

        Einstein's famous equation: $E = mc^2$

        The Pythagorean theorem: $a^2 + b^2 = c^2$
    - name: outputFormat
      value: "pptx-editable"

# Result: {{steps.create_editable_pptx.result}}
# A signed URL to download the editable PPTX file

Example: Company Presentation PDF

- id: generate_company_presentation
  name: generate_company_presentation
  tool: MARP_CONVERT
  input:
    - name: markdown
      value: |
        ---
        marp: true
        theme: uncover
        ---

        # Q1 2026 Results

        Company Performance Review

        ---

        ## Key Metrics

        - Revenue: $10M (+25% YoY)
        - Customers: 5,000 (+40% YoY)
        - Employee Satisfaction: 92%

        ---

        ## Market Expansion

        - Entered 3 new markets
        - Launched 5 new products
        - Formed 10 strategic partnerships

        ---

        ## 2026 Goals

        - Double revenue to $20M
        - Reach 10,000 customers
        - Expand to 10 new markets

        ---

        # Thank You!

        Questions?
    - name: outputFormat
      value: "pdf"

# Result: {{steps.generate_company_presentation.result}}
# A signed URL to download the PDF file

Theme Options

Theme	Style	Best For
default	Clean, minimal	General presentations
gaia	Modern, colorful	Creative/design presentations
uncover	Bold, dramatic	Executive/keynote presentations

Markdown Syntax

Slide Separators

Use --- to create a new slide:

# Slide 1

---

# Slide 2

Headings

• # Heading - Main title slide
• ## Heading - Section heading
• ### Heading - Subsection

Lists

- Bullet point 1
- Bullet point 2
  - Nested point

1. Numbered item 1
2. Numbered item 2

Code Blocks

```javascript
function greet(name) {
  console.log(`Hello, ${name}!`);
}
```

Math Equations

• Inline: $E = mc^2$
• Block: $$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

Use Cases

• Technical Presentations: Code examples, architecture diagrams
• Educational Content: Math formulas, scientific presentations
• Business Reviews: Quarterly reports, strategy presentations
• Portable Presentations: PDF files that work on any device
• Version Control: Track presentation changes in Git
• Collaborative Editing: Edit presentations as Markdown files

Best Practices

Content Structure

• One idea per slide
• Use visual hierarchy (headings, bullets)
• Keep text concise
• Include speaker notes in comments

Styling

• Choose theme based on audience and purpose
• Use consistent formatting
• Limit colors and fonts
• Test slides on target display

Accessibility

• Use high contrast colors
• Provide alt text for images
• Keep font sizes readable
• Include text transcripts for screen readers

Performance

• Optimize image sizes
• Minimize custom CSS
• Test on target browsers
• Consider offline viewing requirements