Chapter 39 Bookdown cheat sheet

Here’s where I park little examples for myself about bookdown mechanics that I keep forgetting.

The bookdown book: https://bookdown.org/yihui/bookdown/

39.1 Heading blah blah

39.2 About labelling things

You can label chapter and section titles using {#label} after them, e.g., we can reference Section 39.2. If you do not manually label them, there will be automatic labels anyway, e.g., this reference to the unlabelled heading 39.1 uses the automatically generated label \@ref(heading-blah-blah).

39.3 Cross-references

Add an explicit label by adding {#label} to the end of the section header. If you know you’re going to refer to something, this is probably a good idea.

To refer to in a chapter- or section-number-y way, use \@ref(label).

  • \@ref(install-git) example: In chapter 6 we explain how to install Git.

If you are happy with the section header as the link text, use it inside a single set of square brackets:

There are two ways to specify custom link text:

The Pandoc documentation provides more details on automatic section IDs and implicit header references.

39.4 Figures, tables, citations

Figures and tables with captions will be placed in figure and table environments, respectively.

Here is a nice figure!

Figure 39.1: Here is a nice figure!

Reference a figure by its code chunk label with the fig: prefix, e.g., see Figure 39.1. Similarly, you can reference tables generated from knitr::kable(), e.g., see Table 39.1.

Table 39.1: Here is a nice table!
Sepal.Length Sepal.Width Petal.Length Petal.Width Species
5.1 3.5 1.4 0.2 setosa
4.9 3.0 1.4 0.2 setosa
4.7 3.2 1.3 0.2 setosa
4.6 3.1 1.5 0.2 setosa
5.0 3.6 1.4 0.2 setosa
5.4 3.9 1.7 0.4 setosa
4.6 3.4 1.4 0.3 setosa
5.0 3.4 1.5 0.2 setosa
4.4 2.9 1.4 0.2 setosa
4.9 3.1 1.5 0.1 setosa
5.4 3.7 1.5 0.2 setosa
4.8 3.4 1.6 0.2 setosa
4.8 3.0 1.4 0.1 setosa
4.3 3.0 1.1 0.1 setosa
5.8 4.0 1.2 0.2 setosa
5.7 4.4 1.5 0.4 setosa
5.4 3.9 1.3 0.4 setosa
5.1 3.5 1.4 0.3 setosa
5.7 3.8 1.7 0.3 setosa
5.1 3.8 1.5 0.3 setosa

You can write citations, too. For example, we are using the bookdown package (Xie 2019) in this sample book, which was built on top of R Markdown and knitr (Xie 2015).