Build Engineering Talk Slides from Markdown

Title slide then a problem slide

Two horizontal slides. The --- is the only thing creating the break.

# Zero-downtime migrations
@yourhandle · KubeCon

---

## Why it's hard

- Schema changes lock tables
- Old and new code run at once

A live-coding style code slide

Fenced block renders verbatim. No color, so rely on whitespace and short lines.

## The expand step

```go
func Migrate(db *sql.DB) error {
    _, err := db.Exec(`ALTER TABLE users ADD COLUMN email_v2 text`)
    return err
}
```

Problem then fix as a vertical stack

---- keeps the contrast on one logical slide the audience steps through.

## The bug

```js
await Promise.all(items.map(save)) // floods the DB
```

----

## The fix

```js
for (const i of items) await save(i)
```

A benchmark table slide

GFM table renders directly — no screenshot needed.

## Throughput

| Approach   | req/s | p99   |
|------------|-------|-------|
| Sync loop  | 1,200 | 90ms  |
| Batched    | 4,800 | 110ms |

Closing slide with links

Autolinks and Markdown links render; the deck's hash routing makes each slide linkable.

## Resources

- Repo: github.com/me/talk
- [Full write-up](https://example.com/post)

Thanks!

Reveal does not wrap <pre> content; long lines run off the slide edge. Break the line in source or shorten the sample before converting.

The deck renders code as plain monospaced text. If your talk depends on colored keywords, add highlight.js to the downloaded HTML yourself — the tool will not do it.

Each ## is a title inside the current slide, not a new slide. Add a --- line where you want the break.

A --- inside a fenced code block is part of the code; the splitter only matches --- on its own line outside obvious content. Keep separators on their own line at the document level to be safe.

Reveal.js loads from cdnjs. On a venue with no Wi-Fi the deck renders unstyled. Test on the real network or self-host the assets in the HTML.

There is no notes feature in this tool. Text you write appears on the slide. Add <aside class="notes"> to the HTML by hand if you need presenter view.

A leading ---/--- YAML block is read as separators and creates stray slides. Strip front matter before converting.

A dense code-only file can exceed 500,000 characters on Free while still under 1 MB. The character cap is enforced separately — upgrade or split.

Only one file is converted per run. Merge multiple sources with md-merger first.