In bookdown: Authoring Books and Technical Documents with R Markdown

Cross-references {#cross}

Cross-references make it easier for your readers to find and link to elements in your book.

Chapters and sub-chapters

There are two steps to cross-reference any heading:

1. Label the heading: # Hello world {#nice-label}.

   • Leave the label off if you like the automated heading generated based on your heading title: for example, # Hello world = # Hello world {#hello-world}.
   • To label an un-numbered heading, use: # Hello world {-#nice-label} or {# Hello world .unnumbered}.

2. Next, reference the labeled heading anywhere in the text using \@ref(nice-label); for example, please see Chapter \@ref(cross).

   • If you prefer text as the link instead of a numbered reference use: any text you want can go here.

Captioned figures and tables

Figures and tables with captions can also be cross-referenced from elsewhere in your book using \@ref(fig:chunk-label) and \@ref(tab:chunk-label), respectively.

See Figure \@ref(fig:nice-fig).

par(mar = c(4, 4, .1, .1))
plot(pressure, type = 'b', pch = 19)

Don't miss Table \@ref(tab:nice-tab).

knitr::kable(
  head(pressure, 10), caption = 'Here is a nice table!',
  booktabs = TRUE
)

bookdown documentation built on Oct. 16, 2024, 1:08 a.m.