> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```yaml theme={null}
- 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

```yaml theme={null}
- 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

```yaml theme={null}
- 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:

```markdown theme={null}
# Slide 1

---

# Slide 2
```

### Headings

* `# Heading` - Main title slide
* `## Heading` - Section heading
* `### Heading` - Subsection

### Lists

```markdown theme={null}
- Bullet point 1
- Bullet point 2
  - Nested point

1. Numbered item 1
2. Numbered item 2
```

### Code Blocks

````markdown theme={null}
```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