R Basics

This is a description

View source file

Introduction

Prose goes in a .narration block: it reads as a paragraph on the website, and becomes the speaker notes you talk from on the slides. Press s in the deck to see the notes view.

Consecutive paragraphs can share one block; they stay separate paragraphs on the page and separate notes on the slide.

Content that only makes sense in writing (e.g., a long aside, a table of options, a link dump) goes in an .html-only block and never reaches the deck.

One plot per slide

Each ## heading starts a slide, and the filter closes the slide after every figure, so two plots never share one slide. Prose after a figure introduces the next figure rather than trailing behind the old one.

plot(mtcars$wt, mtcars$mpg)

This narration belongs to the plot below, and lands on its slide as speaker notes.

plot(mtcars$hp, mtcars$mpg)

Deeper headings

### and deeper headings are promoted to slide level, so each becomes its own slide instead of piling onto the previous slide. On the website they stay a normal sub-heading.

A sub-heading

This is its own slide.

Building up a slide

When a slide holds two or more code chunks, the filter expands it into an auto-animate build-up: one step per chunk, earlier chunks staying on screen, and the narration advancing with each step/click.

x <- mtcars$wt
mean(x)

[1] 3.21725

The second chunk arrives on the next step, with the first still visible.

round(sd(x), 3)

[1] 0.978

Callouts

A callout gets a slide of its own. The content is un-boxed and the slide is titled by its own heading.

NoteA note

This box is dropped on the slide, which lets a figure inside it stretch to fit.

CautionAn exercise solution

A collapsed callout is the exception: it keeps its box. Since clicking on slides can be awkward, the collapsed content is held back as a fragment and revealed when you advance. On the website it stays a click-to-open box.

More info

• Quarto revealjs
• Callouts
• the repo README, for the other two ways to build a module

---

Session info

─ Session info ───────────────────────────────────────────────────────────────
 setting  value
 version  R version 4.6.1 (2026-06-24)
 os       Ubuntu 24.04.5 LTS
 system   x86_64, linux-gnu
 ui       X11
 language (EN)
 collate  C.UTF-8
 ctype    C.UTF-8
 tz       UTC
 date     2026-10-23
 pandoc   3.1.3 @ /usr/bin/pandoc
 quarto   1.10.19 @ /usr/local/bin/quarto

──────────────────────────────────────────────────────────────────────────────