Slides

Create presentation slides with Markdown.

Creating Slides

Place Markdown files in the slides/ directory:

slides/
  my-presentation.md
  conference-talk.md

Slide Syntax

Use --- (horizontal rule) to separate slides:

# My Presentation

First slide content

---

## Second Slide

More content here

---

## Third Slide

- Bullet points
- Work great

Reveal.js Integration

The default slides layout uses Reveal.js, a popular presentation framework.

Features included:

Keyboard navigation (arrows, space)
Slide overview (press O)
Speaker notes (press S)
Syntax highlighting
Responsive scaling

Code in Slides

Code blocks are syntax-highlighted:

```rust
fn main() {
    println!("Hello!");
}
```

Tables in Slides

Tables work but keep them simple:

| Feature | Status |
|---------|--------|
| Slides  | ✓      |
| Notes   | ✓      |

No Backlinks

The slides/ collection doesn't participate in backlinks. Slides are standalone presentations—other pages linking to slides won't clutter their content.

Custom Slides Layout

Create layouts/slides.html for custom styling:

<!DOCTYPE html>
<html lang="en">
<head>
    <title>{{title}}</title>
    <!-- Reveal.js CSS -->
</head>
<body>
    <div class="reveal">
        <div class="slides">
            {{content}}
        </div>
    </div>
    <!-- Reveal.js JS -->
</body>
</html>

Tips

Keep slides minimal - One idea per slide
Use large fonts - Code should be readable
Images work - But optimize for web
Test navigation - Arrow keys and spacebar

Example

See the bim intro slides.