caption-reference-eqn.qmd

# Captioning and referencing equations

This section introduces how to add captions to equations, and reference them in text. 

## Overview

* **Teaching**: 5 minutes
* **Exercises**: 5 minutes

## Questions

- How do I caption an equation?
- How do I reference an equation?

### Numbering equations

You can make an equation referencable by adding a label starting with `#eq-` after the equation `$$`. For example:

```
$$
Y \sim X\beta_0 + X\beta_1 + \epsilon
$$ {#eq-linear}
```

Gives

$$
Y \sim X\beta_0 + X\beta_1 + \epsilon
$$ {#eq-linear}


You can then refer to the equation in text using `@eq-linear`:

> Our model is given in @eq-linear.

## Other equation-adjacent referencing

You can also use and reference theorems, lemmas, conjectures, and many more - to see these, see the Quarto documentation: [theorems and proofs documentation](https://quarto.org/docs/authoring/cross-references.html#theorems-and-proofs).