Slots & layouts

Route Markdown into named layout regions with the :: name :: marker.


Each slide picks a layout. A layout is a named grid from the master. You route Markdown into the layout’s slots.

Routing content into slots

Put :: name :: on its own line. The Markdown after it goes into the slot called name. Text before any marker goes to the main slot. That is body if it exists, otherwise the first slot.

layout: two-cols
---
:: title ::
## Input vs. output

:: left ::
**You write this**

:: right ::
**Your audience sees**
> A typographic, animated, full-bleed presentation.

Slot names are defined per layout in the master. So the slots you can use depend on the layout you pick. Run slaide slots on a deck to print the master’s vocabulary. It lists every layout and the slots, colors, gradients, and sizes it exposes.

Bundled aurora layouts

The default theme ships these layouts:

cover · title-content · section · two-cols · image-right · image-left · content-sidebar · quote · full-bleed · blank

A custom theme can define any layouts it likes. Names are per theme. A theme’s two-col is not the same as aurora’s two-cols.

Layers

Every slide stacks three layers, painted in this order:

  1. Background. Solid, gradient, or image, from the master. Set per layout or per slide.
  2. Content. Your Markdown, flowed through the layout’s slots.
  3. Chrome. Header, footer, page number, and corner logo. Sits above the content.

Chrome

Headers and footers are three-cell bands. The cells are left, center, and right. Their text can hold {{placeholders}}. A corner logo sits in a corner you choose.

Per-slide footer:, chrome:, and logo: override the defaults. So a cover can show only the header, and a closing slide can hide the chrome entirely.

See Authoring a theme to define your own layouts and chrome.