Write your presentation in Markdown.

Preamble is a Mac app that turns a Markdown file into a presentation with live preview and HTML export.

  • Free under the MIT License
  • Source available on GitHub
  • The Mac app sends no telemetry

Requires an Apple silicon Mac running macOS 13 or later.

Change 180 to 150.

The new index cut p95 latency by 57%.

p95 API latency
Data for p95 API latency
LabelValue
Previous query420 ms
Indexed query180 ms

Add equations, code, charts, and audience questions.

Each example is compiled from the Markdown stored with this site. The Mac app uses the same compiler and renderer.

LaTeX

Editable equations

Inline and display equations use familiar LaTeX syntax and remain editable in the source file.

Coffee cools fastest while it is hottest.

For ambient temperature TaT_a, Newton's law of cooling gives:

T(t)=Ta+(T0Ta)ektT(t) = T_a + (T_0 - T_a)e^{-kt}

Fenced code

Syntax-highlighted code

Set the language on a fenced block to add syntax highlighting in the app and exported HTML.

Backoff keeps retries from becoming a traffic jam.

from random import uniform

def retry_delay(attempt):
    ceiling = min(2 ** attempt, 30)
    return uniform(0, ceiling)

:::chart

Charts from labelled values

Write a labelled YAML series and choose a bar or line chart. Preamble also includes the source data in an accessible table.

Thursday's queue was less than half of Tuesday's.

Open support tickets at noon
Data for Open support tickets at noon
LabelValue
Monday48
Tuesday62
Wednesday44
Thursday29

:::quiz

Audience questions

A YAML block holds the prompt, choices, correct answer, and explanation.

The server asked the browser to slow down.

Choose an answer

Which HTTP status code means "Too Many Requests"?

Choose the presentation style in the file header.

The theme setting controls typography, colour, and component styling across every slide.

The source file stays on your Mac.

Preamble reads and writes .preamble.md files in a folder you choose, so text editors and version-control tools can open them. HTML export writes one self-contained file that opens in a modern browser.

Browse the code on GitHub

Start your next presentation in Markdown.

Download the Mac beta