References

A reference is an internal link — a way to jump from one slide to another in the same deck. It's the companion to labels: you label a slide with ::id, then reference it with :[id].

Defining the target

First, give the slide you want to link to an ID, using :: on its heading:

## Results ::results

Linking to it

Anywhere in your content, write :[id] to create a link that jumps to that slide:

The data backs this up — see :[results].

By default the link shows the target slide's title. To use your own wording instead, add it after a comma:

As shown earlier in the :[results, experimental results], the trend is clear.

Why bother?

References turn a flat stack of slides into something more like a connected document. A few places they shine:

• A table-of-contents slide that links to each section.
• Forward references — "we'll return to this in :[conclusions]".
• Pointing back to a key figure or definition from a later slide.

Labels and references go together

If a reference isn't working, check that the target slide actually has a matching ::id. The id in :[id] must exactly match the one you defined. See Labels for the full story.