Bibliography

Planned feature

Citations are not yet implemented. The directive /cite[id] is reserved and
parsed, but it currently renders as literal text on the slide rather than a
formatted citation — there is no bibliography file, no key resolution and no
reference list. An earlier draft of this page described an @[key] operator;
that form was dropped.

The intended shape

When it lands, a citation will be a directive attached where the marker should
appear:

The bound was first proved by Shannon /cite[shannon1948].

…resolved against a bibliography declared in the frontmatter, and collected
into a reference slide at the end of the deck.

What to do today

Cite inline, briefly. On a slide, a full reference is noise; the audience
needs enough to find the paper afterwards.

The bound was first proved by Shannon (1948).

Put the full references on a labelled slide and link to it:

## References                                    ::refs

- Shannon, C. E. (1948). *A Mathematical Theory of Communication*.
  Bell System Technical Journal, 27(3), 379–423.
- Hamming, R. W. (1950). *Error Detecting and Error Correcting Codes*.

…see :[refs, the references].

Or use a small muted line where the claim is made — a
span with a class
gives you a caption style you can reuse:

[Shannon 1948, Bell Syst. Tech. J. 27(3)]{.cite}

===
css: .cite { font-size: 0.6em; color: var(--tac-text-muted) }
===

Related

Footnotes are planned too, and for the same reason — an aside
that shouldn't compete with the main text of a slide.