Generate professional slide deck presentations from markdown with support for multiple output formats.

1. Create a new issue using the Presentation Request template
2. Fill in your presentation requirements
3. Submit the issue with the presentation label
4. The workflow automatically generates your presentation and creates a PR

# Install dependencies
pip install reportlab python-pptx Pillow jinja2 markdown pyyaml

# Generate presentation
python docs/presentations/generate.py \
  --input docs/presentations/drafts/my-presentation.md \
  --output docs/presentations/output \
  --formats pdf,html,pptx \
  --style systematic-velocity

Dark theme with coral accents. Data-focused with geometric elements.

• Background: #1A1A1A
• Accent: #DA7756
• Best for: Technical talks, data presentations

Light theme with blue accents. Professional with generous whitespace.

• Background: #FFFFFF
• Accent: #2563EB
• Best for: Corporate presentations, training

Dark blue with cyan accents. Code-focused with grid elements.

• Background: #0F172A
• Accent: #06B6D4
• Best for: Architecture talks, developer presentations

White with vibrant gradients. High-contrast with strong CTAs.

• Background: #FFFFFF
• Accent: Purple→Pink gradient
• Best for: Sales pitches, product launches

---
title: "Presentation Title"
subtitle: "Optional Subtitle"
author: "Author Name"
date: 2025-12-29
style: systematic-velocity
format:
  - pdf
  - html
---

# Section Title

---

## Slide Title

- Bullet point 1
- Bullet point 2

::: notes
Speaker notes go here.
:::

---

## Metrics Slide

<!-- metric: value="95%" label="Success Rate" -->
<!-- metric: value="3x" label="Performance Gain" -->

---

## Code Example

```python
def hello():
    return "Hello, World!"

::: columns :::: column

• Point A
• Point B :::: :::: column

• Point C
• Point D :::: :::

## Directory Structure

docs/presentations/ ├── generate.py # Main generation script - handles PDF, PPTX, HTML output ├── README.md # This documentation file ├── templates/ # Style templates for theming │ ├── systematic-velocity/ # Dark theme with coral accents (default) │ ├── clean-minimal/ # Light theme with blue accents │ ├── technical-blueprint/ # Dark blue with cyan, code-focused │ └── marketing-bold/ # White with gradient CTAs ├── drafts/ # Source markdown files for presentations │ └── example-presentation.md # Sample presentation demonstrating format ├── output/ # Generated presentation files │ ├── example.pdf # Print-ready PDF with embedded fonts │ ├── example.pptx # Editable PowerPoint format │ └── example/ # Reveal.js HTML presentation │ ├── index.html # Main presentation file │ └── assets/ # Bundled CSS, JS, and images └── assets/ # Shared resources across presentations ├── fonts/ # Custom typography (Inter, JetBrains Mono) ├── images/ # Logos, icons, and graphics └── brand/ # Color palettes and style guides

## Example Output

When you generate a presentation from markdown, you get:

| Format | Output | Description |
|--------|--------|-------------|
| **PDF** | `output/my-deck.pdf` | Fixed-layout slides with embedded fonts, ideal for printing or sharing |
| **PPTX** | `output/my-deck.pptx` | Editable PowerPoint with speaker notes, animations supported |
| **HTML** | `output/my-deck/index.html` | Reveal.js presentation with keyboard navigation, presenter mode |

### Sample Generated Slide (Systematic Velocity Style)

┌─────────────────────────────────────────────┐ │ ████████████████████████████████████████ │ <- #1A1A1A background │ │ │ THE CHALLENGE │ <- #EBEBEB heading │ │ │ > "Quote highlighting pain point" │ <- #DA7756 accent │ │ │ • Problem statement 1 │ │ • Problem statement 2 │ │ • Problem statement 3 │ │ │ │ ████████████████████████████████████████ │ └─────────────────────────────────────────────┘

## Workflow Integration

### Reusable Workflow

```yaml
jobs:
  generate:
    uses: zircote/.github/.github/workflows/reusable-presentation.yml@main
    with:
      source: 'docs/presentations/drafts/my-deck.md'
      formats: 'pdf,html,pptx'
      style: 'systematic-velocity'
    secrets: inherit

# Required
pip install pyyaml

# For PDF generation
pip install reportlab Pillow

# For PowerPoint generation
pip install python-pptx Pillow

# For HTML generation
pip install jinja2 markdown

• Presentation Skill - AI skill definition
• Issue Template - GitHub issue form