writing / 04 of 13

Slides and front matter

A deck is one markdown file. Four dashes split it into slides, and the YAML at the top of a slide configures that slide.

Splitting the file

A line of four dashes, ----, ends one slide and starts the next. Everything between two of them is one slide, in order.

For a horizontal rule inside a slide, use ***.

Front matter

A slide has front matter when its first line, after any blank lines, is ---. The YAML runs to the next --- line, and the slide’s markdown follows.

markdown

---
title: Results
transition: slideUp
border: thick
---

## What we measured

Front matter keys

key	values	what it does
`title`	text	Names the slide in the command palette. Untitled slides are listed as `#3` and so on.
`transition`	`none` `swipeLeft` `swipeRight` `slideUp` `slideDown` `flip` `collapse` `expand` `fade`	The animation that brings this slide in. Transitions describes each one.
`border`	`rounded` `normal` `thick` `double` `block` `innerHalfBlock` `outerHalfBlock` `hidden`	The frame drawn around the slide. See Borders.
`border_color`	`"#RRGGBB"`, or an ANSI number like `"63"`	The frame’s colour.
`layout`	a horizontal and a vertical position, like `center,bottom`	Where the content sits inside the frame. See Placing content.
`theme`	`dark` `light` `dracula` `tokyo-night` `pink` `ascii` `notty`, or a path to a JSON style	The Glamour style the markdown is rendered with.
`preset`	a name under `presets:` in kyma.yaml	Start from that preset instead of the global style.
`master`	a name under `masters:`, or a file path	Pour the slide into a master layout.
`notes`	markdown	Shown only in speaker notes mode.

Names are case-sensitive: swipeLeft, not swipeleft.

Where values come from

A key a slide leaves out comes from kyma.yaml: from the preset the slide names, or from the global section when it names none. The kyma.yaml that kyma writes on first run gives every slide a rounded lavender border, centred content and the dracula theme.