Slides

In Tachyonn, you don't create slides with a menu or a button — you create them by writing headings. The number of # characters decides what kind of slide you get. This page covers everything about defining and configuring slides.

Section slides — one #

A single # creates a section slide: a full-bleed divider that announces a new part of your talk. They typically have a solid background and a large, centered title, and by default they don't show a footer — the idea is to feel like turning to a new chapter.

# Part I — Foundations

Use these to give your presentation a clear skeleton. As a bonus, they're the targets for the Shift + arrow section-jump shortcuts.

Content slides — two ##

Two hashes start a content slide — the workhorse of any deck. It gets a title at the top and holds whatever content you write beneath it:

## Introduction to Quantum Mechanics

The content of the slide goes here.

Everything after the ## belongs to this slide until the next heading appears.

Repeating a title across slides

A single topic often spans several slides. Instead of retyping the heading,
leave the ## empty — the slide inherits the previous content slide's
title automatically:

## Results
The first chart…

##
The second chart, under the same "Results" title.

When you genuinely want a slide with no title, you have two options:
set title: none in the per-slide frontmatter, or pick a layout that doesn't
show a title (like quote or big-number).

##
===
title: none
===
A slide with no heading at all.

Highlight boxes — three ###

A third hash does not start a new slide. Instead it opens a highlight
box (an admonition, like LaTeX's Beamer blocks) inside the current slide.
The text after ### becomes the box's title bar; leave it empty for a box
with no title bar. The box holds everything until the next heading.

## Methodology

### Data collection
Text about collecting data…

###<alert> Watch out
A caveat worth highlighting.

###
A box with no title bar — just the tinted body.

Pick a variant with a short <…> modifier right after the hashes (the
shortcut and the full name are interchangeable):

Modifier	Box
(none) / <s> / <standard>	Standard (neutral)
<a> / <alert>	Alert (attention)
<e> / <example>	Example

The colors come from the theme (--tac-callout-standard, --tac-callout-alert,
--tac-callout-example), so they stay consistent with your deck — and you can
define your own variant by adding a --tac-callout-<name> to a theme and
writing ###<name>.

Slide IDs

Add ::someId to the end of any heading to give that slide a stable identifier:

## Conclusions ::conclusions

## References ::refs

IDs are how you link between slides. Elsewhere in your deck, writing :[conclusions] creates an internal link that jumps to that slide. (See References.)

The automatic cover slide

You don't write your title slide — Tachyonn builds it for you from the frontmatter. As long as you set a title, a cover slide appears as the very first slide:

===
title: Quantum Physics
subtitle: An Introduction
author: Prof. Ana Souza
===

If you'd rather not have an automatic cover, turn it off:

===
title: My presentation
cover: false
===

Per-slide settings

Most settings live in the deck's frontmatter, but you can override them for a single slide. Just open a small ===...=== block right after the ## title:

## A slide with its own background
===
background: #1a1a2e
transition: fade
footer: false
===

The content of this slide.

The keys you can set per slide:

Key	Example	What it does
transition	fade, slide, slide-in, slide-out-in, zoom, magic, none	The entrance transition (see the cheatsheet; set it in the deck frontmatter or tac.config to change every slide at once)
notes	Pause here	A speaker note for this slide
layout	two-column	Switches this slide's layout
footer	false / true	Force the footer off or on
background	#1a1a2e	Background color
accent	#38bdf8	Local accent color
valign	top / center / bottom	Vertical alignment of the content
class	text-center	An extra CSS class

Switching layout with /layout

Besides the per-slide frontmatter, you can change a slide's layout inline with the /layout directive, placed right after the title:

## Comparing the data
/layout[two-column]

Left-hand text.
---
Right-hand text.

There are eleven layouts to choose from — see the full catalog in Layouts.