mdeck 3.2.0 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 3.4.0 — 2026-10-08
+
+- What follows a list has room above it in every theme, so a sentence after a list no longer sits right against its last item.
+- Fixed: a bullet list inside a numbered list took numbers too, and in some themes the number sat on top of the bullet; it also pushed the numbering of the items after it. Every built-in theme now styles only a list's own items.
+- A list inside a list item has room above it, as much as between its own items and less than between the outer ones, instead of sitting right against its item. Themes with their own spacing for nested lists keep it.
+- Links and quotations look the part in every theme: links take the palette's accent colour instead of the browser's blue, and a `> quotation` is set in each theme's own way instead of as a bare indent: academic as an indented serif quotation, aurora with a quotation mark in its gradient, minimal and neue with a bar at its side (grey and red). A quotation's paragraphs now take the quotation's type, which themes that set every paragraph's font used to undo.
+- The sample deck, on which `mdeck design`, the theme gallery and the theme checks show every theme, now also has a link, a quotation, a bullet list inside a numbered list, citations with their references at the foot of the slide, and a reference list.
+- A poll's question and options may use Markdown and `$…$` maths, as on a slide: `options="$2x$|$x^2$|$\frac{x^3}{3}$"`. The slide draws them with KaTeX, the phones' answer page as MathML, which needs no fonts or scripts there; it keeps only text, emphasis and MathML from what the presenter's screen sends. A `|` inside a formula belongs to it (`$|x|$`), and `\|` is a bar in the text. Votes and `answer` still use the text as written. The same goes for the `question` of every activity (`<scale>`, `<question>`, `<wordcloud>`) and the scale's `low` and `high` labels. An answer page from an older `mdeck server` shows the source text.
+- Fixed: the phones' answer page showed the word “null” below the question when there was no link for following the slides.
+- Every activity has a lock button that closes it: answers after that do not count, and the phones say it is closed until it opens again. Together with the eye (`results="hidden"`) and the tick this makes a peer-instruction round: vote, close, show the bars, discuss, show the answer.
+- Showing a poll's right answer also tells each phone whether its vote was right, or what the right answer is. The lock, the eye and the tick are kept in the activity room's state on the server, so every screen of the talk and the phones follow them, also after a reload.
+- Polls, scales and numbers count “12 of 31 answered” while phones are connected.
+- `multiple` lets each phone pick several options of a poll; the slide and the phones say so. `buttons="letters"` (or `"numbers"`) puts A, B, C before the options on the slide and shows only those on the phones, for options that are pictures or long formulas.
+- New activity `<numeric>`: phones type a number (`0.5`, `0,5`, `1/2`), the slide shows the most frequent answers as bars. `answer` and `tolerance` mark the right ones and tell each phone whether it was right.
+- The answers of a talk are kept beside the deck in `<slides>.results.json` while `mdeck run` runs: anonymous, phones numbered per question. Builds, `mdeck send` and `mdeck pdf` show them as the record of the talk (`--no-results` leaves them out), and `mdeck results` prints them as CSV.
+- Fixed: a `>` or `<` in an activity's attributes (`question="Is $x > 0$?"`) cut its tag short, and the phones lost the options. Pictures in a tag's attributes, such as a poll's options, are now copied into folder builds.
+
+## 3.3.0 — 2026-10-08
+
+- Citations and references: `bibliography: refs.bib` in the deck settings, then cite in Pandoc's syntax, `[@smith2020, p. 12]`, `[see @a; @b]`, `[-@a]` or `@smith2020` in a sentence. Each citation shows in the style's short form, each slide lists the full references of the works it cites above its footer (`show.citations: false` leaves them out), and `<bibliography />` lists them all on a slide (`part="1/2"` splits a long list). Reference files may be BibTeX (`.bib`), CSL-JSON (`.json`) or Hayagriva (`.yml`, Typst's format), several at once. `csl:` picks the style, `apa` by default, `vancouver`, `harvard1` or any `.csl` file; the style's words follow `lang`. `nocite:` lists works without citing them. Formatting happens at build time, so a deck carries only the finished text. Unknown keys are marked on the slide and reported by `mdeck check`.
+- `mdeck check --render` looks at the deck in Chrome: it builds it, shows every slide with all steps revealed, and reports content that does not fit, text cut off at the slide's edge or hard to read on what is behind it, and errors the page reports, each with the slide's number, heading and line. `mdeck snapshot` saves slides as PNG files (`--slide 3,5-7`, `--dark`, `--light`, `-o`; by default in `.mdeck-snapshots/`), so a person or an assistant can look at them. The slide-writing skill uses both.
+- New view `?view=follow`: people in the room follow the talk on their phone or laptop. It shows the slide the presenter shows, step by step, and their drawing, read from the stage room without sending anything; people can page back and return with **Back to live**, and never see a slide or step before the presenter shows it. `<qrcode follow />` shows its link on a slide, the phones' answer page links to it (**Follow the slides**), and `mdeck run --network` prints it. It works on the same network with `mdeck run --network`, and anywhere for a deck hosted with a `server` setting. Followers count as phones in the presenter's overview of who is connected.
+- Fixed: a web video (YouTube, Vimeo, SwitchTube) in `<videoplayer>`'s click mode went on playing, with sound, after leaving its slide. Leaving the slide now stops it; coming back shows it ready to play.
+- Straight lines snap to steps of 15° (horizontal, vertical, 45° …) when they are within 4° of one, both when a held stroke straightens and when an end point is dragged; further off they stay as drawn.
+- Polls have a button with an eye that shows or hides the results (bars and counts), also in the audience window and on paired devices. `results="hidden"` starts with them hidden, e.g. for peer instruction; the audience then sees no bars, the presenter's own screens show them faint.
+- `--no-polls` leaves slides with a poll, question, word cloud, scale or join code (`<qrcode join />`) out of `mdeck send`, `mdeck build --reader` and `mdeck pdf`. By default they stay as a record of the talk. Drawings stay on their slides.
+
 ## 3.2.0 — 2026-10-07
 
 - Pictures written in the text fit on the slide in every theme: a paragraph of nothing but pictures shrinks into the room below the heading instead of running off the slide, keeping its proportions (small pictures keep their size), and several pictures in one paragraph sit side by side. Such paragraphs have the class `pictures`, for themes that set them their own way; a picture in a sentence is left alone.

package/assets/base.css

@@ -105,7 +105,10 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
 .split-right { flex: 1; min-width: 0; display: flex; flex-direction: column; justify-content: safe center; gap: var(--gap-item); }
 
 /* ── List containers ─────────────────────────────────────────────────────── */
+/* Lists have no margins of their own, and paragraphs only one below them, so
+   whatever follows a list needs room above it. */
 .slide-body :is(ul, ol) + :is(ul, ol) { margin-top: var(--gap-item); }
+.slide-body :is(ul, ol) + :not(ul, ol) { margin-top: var(--gap-item); }
 /* Markers (::before), padding, and font styling are visual — defined per theme */
 .slide-body ul {
   list-style: none;
@@ -115,7 +118,7 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
   flex-direction: column;
   gap: var(--gap-item);
 }
-.slide-body ul li { position: relative; }
+.slide-body ul > li { position: relative; }
 .slide-body ol {
   list-style: none;
   padding: 0;
@@ -125,7 +128,10 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
   flex-direction: column;
   gap: var(--gap-item);
 }
-.slide-body ol li { counter-increment: slide-ol; position: relative; }
+.slide-body ol > li { counter-increment: slide-ol; position: relative; }
+/* A list inside an item: closer to its item than items are to each other,
+   and as close inside. Themes with their own (same selector) win. */
+.slide-body li :is(ul, ol) { margin-top: calc(var(--gap-item) * 0.5); gap: calc(var(--gap-item) * 0.5); }
 
 /* ── Full-bleed image ────────────────────────────────────────────────────── */
 .slide--full-bleed-image { padding: 0; }
@@ -159,6 +165,21 @@ deck-stage[data-ink-hidden] .slide-ink { display: none; }
 .slide-footnotes p { margin: 0; }
 .slide-footnotes .footnote-backref { display: none; }
 
+/* ── Links and quotations ───────────────────────────────────────────────── */
+/* Defaults in the palette's colours instead of the browser's blue and a bare
+   indent. :where keeps them weaker than any rule of the theme's own. */
+:where(.slide) a { color: var(--accent); text-underline-offset: 0.15em; text-decoration-thickness: 0.06em; }
+:where(.slide) blockquote {
+  margin: 0 0 var(--gap-item);
+  padding-left: 0.9em;
+  border-left: 4px solid var(--accent);
+  color: var(--ink-soft);
+}
+:where(.slide) blockquote > p:last-child { margin-bottom: 0; }
+/* The quote's paragraphs take its type: themes set the face and size of
+   every paragraph, which would undo a quote set in its own. */
+.slide-body blockquote > p { font: inherit; color: inherit; letter-spacing: inherit; }
+
 /* ── Code blocks ─────────────────────────────────────────────────────────── */
 .code-block { white-space: pre-wrap; overflow-x: hidden; }
 

package/assets/extensions/themes/academic/styles.css

@@ -180,12 +180,12 @@ strong { color: var(--ink); font-weight: 700; }
    the text size, so long lists stay compact
    ───────────────────────────────────────────── */
 .slide-body ul, .slide-body ol { max-width: 1560px; }
-.slide-body ul li,
-.slide-body ol li {
+.slide-body ul > li,
+.slide-body ol > li {
   line-height: 1.45;
   padding-left: 44px;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 4px;
@@ -195,7 +195,7 @@ strong { color: var(--ink); font-weight: 700; }
   background: var(--accent);
   clip-path: polygon(0 0, 100% 50%, 0 100%);
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol) '.';
   position: absolute;
   left: 0;
@@ -206,7 +206,7 @@ strong { color: var(--ink); font-weight: 700; }
 }
 /* Second level: an en dash, a little smaller */
 .slide-body li :is(ul, ol) { margin-top: 8px; gap: 6px; font-size: 0.88em; }
-.slide-body li ul li::before {
+.slide-body li ul > li::before {
   width: 0.5em;
   height: 2px;
   top: 0.72em;
@@ -579,6 +579,21 @@ strong { color: var(--ink); font-weight: 700; }
 }
 .slide-footnotes li { line-height: 1.4; }
 .slide-body sup { color: var(--accent); font-weight: 600; }
+.slide-citations { font-family: var(--font-body); }
+.slide-citations:not(.slide-footnotes + .slide-citations) {
+  border-top: 0;
+  position: relative;
+  padding-top: 14px;
+}
+.slide-citations:not(.slide-footnotes + .slide-citations)::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 280px;
+  height: 1px;
+  background: var(--ink-soft);
+}
 
 /* ─────────────────────────────────────────────
    CODE — a listing on the surface, a rule at its side
@@ -629,3 +644,16 @@ strong { color: var(--ink); font-weight: 700; }
   overflow-y: hidden;
 }
 .slide .katex-display > .katex { font-size: 1.2em; }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — the quote environment of a printed text: set in from
+   both sides, in the serif, without ornament
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 0 64px;
+  border: 0;
+  font-family: var(--font-serif);
+  font-style: italic;
+  color: var(--ink-soft);
+}

package/assets/extensions/themes/aurora/styles.css

@@ -66,13 +66,13 @@ deck-stage[data-deck-static] .slide::before { animation: none; }
 /* Print and PDF: gradient text prints with a hairline box around it, and
    glows print as dark halos; solid colours instead. */
 @media print {
-  em, .slide-footer > span:last-child:not(:first-child), .chapter-num, .slide-body ol li::before {
+  em, .slide-footer > span:last-child:not(:first-child), .chapter-num, .slide-body ol > li::before {
     background: none !important;
     -webkit-text-fill-color: currentColor !important;
     color: var(--aurora-a) !important;
     filter: none !important;
   }
-  .slide-body ul li::before, .focus-eyebrow::before, .slide-header > span:last-child:not(:empty)::after { box-shadow: none !important; }
+  .slide-body ul > li::before, .focus-eyebrow::before, .slide-header > span:last-child:not(:empty)::after { box-shadow: none !important; }
   /* Frosted glass blurs what lies behind it, which prints as an image. */
   .slide *, .slide *::before { -webkit-backdrop-filter: none !important; backdrop-filter: none !important; }
 }
@@ -457,13 +457,13 @@ strong { color: var(--ink); font-weight: 700; }
 /* ─────────────────────────────────────────────
    LISTS — glowing dots, gradient numbers
    ───────────────────────────────────────────── */
-.slide-body ul li {
+.slide-body ul > li {
   font-weight: 400;
   line-height: 1.35;
   padding-left: 46px;
   position: relative;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -474,11 +474,11 @@ strong { color: var(--ink); font-weight: 700; }
   background: var(--aurora-gradient);
   box-shadow: 0 0 14px color-mix(in oklab, var(--aurora-a) 55%, transparent);
 }
-.slide-body ol li {
+.slide-body ol > li {
   padding-left: 60px;
   position: relative;
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol);
   position: absolute;
   left: 0;
@@ -642,3 +642,29 @@ strong { color: var(--ink); font-weight: 700; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — no pane, only a large quotation mark in the colours of
+   the lights beside the quote
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  position: relative;
+  margin: 0 0 var(--gap-item);
+  padding: 0 0 0 76px;
+  border: 0;
+  max-width: 1300px;
+  color: var(--ink);
+}
+.slide-body blockquote::before {
+  content: '\201C';
+  position: absolute;
+  left: 0;
+  top: -18px;
+  font-size: 120px;
+  font-weight: 800;
+  line-height: 1;
+  background: var(--aurora-gradient);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}

package/assets/extensions/themes/minimal/styles.css

@@ -215,8 +215,8 @@ strong { color: var(--ink); font-weight: 600; }
 /* ─────────────────────────────────────────────
    LISTS — a short dash, plain numbers
    ───────────────────────────────────────────── */
-.slide-body ul li { line-height: 1.4; padding-left: 40px; position: relative; }
-.slide-body ul li::before {
+.slide-body ul > li { line-height: 1.4; padding-left: 40px; position: relative; }
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -225,8 +225,8 @@ strong { color: var(--ink); font-weight: 600; }
   height: 2px;
   background: var(--muted);
 }
-.slide-body ol li { padding-left: 52px; position: relative; }
-.slide-body ol li::before {
+.slide-body ol > li { padding-left: 52px; position: relative; }
+.slide-body ol > li::before {
   content: counter(slide-ol) '.';
   position: absolute;
   left: 0;
@@ -340,3 +340,15 @@ strong { color: var(--ink); font-weight: 600; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — a thin bar in the quiet grey, the quote set in a little,
+   in the softer ink
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 2px 0 2px 28px;
+  border: 0;
+  border-left: 3px solid var(--muted);
+  color: var(--ink-soft);
+}

package/assets/extensions/themes/neue/styles.css

@@ -336,13 +336,13 @@ strong { color: var(--ink); font-weight: 600; }
 /* ─────────────────────────────────────────────
    LISTS — square markers in the accent, numbers in the display face
    ───────────────────────────────────────────── */
-.slide-body ul li {
+.slide-body ul > li {
   font-weight: 400;
   line-height: 1.32;
   padding-left: 44px;
   position: relative;
 }
-.slide-body ul li::before {
+.slide-body ul > li::before {
   content: '';
   position: absolute;
   left: 0;
@@ -351,12 +351,12 @@ strong { color: var(--ink); font-weight: 600; }
   height: 14px;
   background: var(--accent);
 }
-.slide-body ol li {
+.slide-body ol > li {
   counter-increment: slide-ol;
   padding-left: 64px;
   position: relative;
 }
-.slide-body ol li::before {
+.slide-body ol > li::before {
   content: counter(slide-ol, decimal-leading-zero);
   position: absolute;
   left: 0;
@@ -487,3 +487,16 @@ strong { color: var(--ink); font-weight: 600; }
   overflow-x: auto;
   overflow-y: hidden;
 }
+
+/* ─────────────────────────────────────────────
+   QUOTATIONS — a rule, not a box: a red bar to the left, the quote set
+   in a little, in the text's own size
+   ───────────────────────────────────────────── */
+.slide-body blockquote {
+  margin: 0 0 var(--gap-item);
+  padding: 2px 0 2px 32px;
+  border: 0;
+  border-left: 6px solid var(--accent);
+  max-width: 1200px;
+  color: var(--ink);
+}

package/docs/reference/authoring.md

@@ -63,6 +63,10 @@ Each `---` line starts a new slide. Frontmatter is only needed when you want a s
 | `params` | — | Theme-specific color/font overrides (see below) |
 | `reader.themes` | `true` | Whether the reader view offers a switch between light and dark (see below) |
 | `reader.notes` | `false` | Whether the reader view shows speaker notes under each slide in Read mode |
+| `bibliography` | — | Reference file, or a list of them, relative to the deck: `.bib`, `.json` (CSL-JSON) or `.yml` (Hayagriva) (see [Citations](#citations-and-references)) |
+| `csl` | `apa` | Citation style: `apa`, `vancouver`, `harvard1`, or a `.csl` file |
+| `nocite` | — | References to list without citing them; `['*']` lists the whole file |
+| `show.citations` | `true` | `false` leaves out each slide's own references above the footer |
 
 ### Theme params
 
@@ -87,7 +91,8 @@ reader:
 ```
 
 Views are chosen with one address parameter: `?view=deck`, `?view=reader`,
-`?view=presenter` or `?view=audience`. `mdeck send` produces a file that opens
+`?view=presenter`, `?view=audience` or `?view=follow` (the presenter's slide and
+ink on another device, read from the stage room; never ahead of the presenter). `mdeck send` produces a file that opens
 in the reader view (outline, Read mode, a light/dark switch, PDF download).
 The file carries only the deck's own theme and palette, with that theme's
 fonts, so readers see the deck as it was made; they can switch between its
@@ -376,6 +381,52 @@ This claim needs a source.[^1]
 [^1]: The source citation goes here.
 ```
 
+### Citations and references
+
+Name a reference file in the deck frontmatter and cite its entries by key, in the syntax Pandoc and Quarto use:
+
+```markdown
+---
+bibliography: refs.bib
+csl: apa
+---
+# Results
+
+As @smith2020 showed, it works [see @smith2020, p. 12; @doe2019].
+
+---
+# References
+
+<bibliography />
+```
+
+| Written | APA | Vancouver |
+|---|---|---|
+| `[@smith2020]` | (Smith et al., 2020) | (1) |
+| `[@smith2020, p. 12]` | (Smith et al., 2020, p. 12) | (1) |
+| `[see @smith2020; @doe2019]` | (see Smith et al., 2020; Doe, 2019) | (1,2) |
+| `[-@smith2020]` | (2020) | (1) |
+| `@smith2020` | Smith et al. (2020) | Smith et al. (1) |
+| `@smith2020 [chap. 3]` | Smith et al. (2020, Chapter 3) | Smith et al. (1) |
+
+- **On the slide** each citation shows in the style's short form, and the full reference of every work the slide cites stands in small type above the footer, after any footnotes. `show.citations: false` leaves those out.
+- **`<bibliography />`** lists every cited work, plus those named in `nocite`, in the style's order. A list too long for one slide goes on several: `<bibliography part="1/2" />` on one and `<bibliography part="2/2" />` on the next split it in halves.
+- **Locators** after a comma: `p.`/`pp.`, `chap.`, `sec.`, `fig.`, `vol.`, `para.`, `no.`, `l.`, `eq.` and the German `S.`, `Kap.`, `Abb.`, `Bd.`, `Nr.`; a bare number is a page.
+- **`@key` without brackets** is a citation only when the key is in the reference file, so e-mail addresses and `@handles` stay text. Citations in code, in links' addresses and in `:::notes` blocks work as in slide text, except that notes show no reference footer.
+- **A key that is not in the file** shows as `@key?`, marked, and `mdeck check` and `mdeck build` warn about it.
+
+**Reference files.** `bibliography` takes one file or a list:
+
+| Extension | Format | Comes from |
+|---|---|---|
+| `.bib` | BibTeX / BibLaTeX | Zotero, JabRef, Google Scholar, most journals |
+| `.json` | CSL-JSON | Zotero ("CSL JSON"), Pandoc |
+| `.yml`, `.yaml` | Hayagriva (Typst), or CSL-YAML when the file is a list | Typst projects |
+
+**Styles.** `apa`, `vancouver` and `harvard1` are built in. Any other style from the [CSL style repository](https://www.zotero.org/styles) works as a file next to the deck: `csl: nature.csl`. The style's words (`p.`/`S.`, `and`/`und`, `et al.`/`u. a.`) follow the deck's `lang`; English, German, French, Spanish and Dutch are included, other languages fall back to English. Note styles (such as Chicago notes-bibliography) are written for footnotes; on slides an author-date or numeric style reads better.
+
+The references are formatted when the deck is built, so the deck carries only the finished text and works offline; the dev server reformats them when the deck or a reference file changes.
+
 ---
 
 ## Code blocks
@@ -533,8 +584,28 @@ labels:
 | `respond.send` | Send | Senden |
 | `respond.sent` | Sent. Thank you! | Gesendet. Danke! |
 | `join.scan` | Scan to join | Scannen und mitmachen |
+| `follow.scan` | Scan to follow the slides | Scannen und Folien mitverfolgen |
+| `follow.open` | Follow the slides | Folien mitverfolgen |
+| `follow.live` | Live | Live |
+| `follow.back` | Back to live | Zur aktuellen Folie |
+| `follow.waiting` | The talk has not started yet. | Der Vortrag hat noch nicht begonnen. |
+| `follow.tryHere` | Try following here | Mitverfolgen hier ausprobieren |
 | `question.empty` | Answers appear here. | Hier erscheinen die Antworten. |
 | `scale.average` | Average {n} | Durchschnitt {n} |
+| `poll.answeredOf` | {n} of {of} answered | {n} von {of} haben geantwortet |
+| `poll.closed` | Closed | Geschlossen |
+| `poll.several` | Several answers possible. | Mehrere Antworten möglich. |
+| `poll.pickSeveral` | Tap all that apply. | Alle zutreffenden antippen. |
+| `poll.thanksSeveral` | Thanks! You chose {choice}. Tap to change. | Danke! Gewählt: {choice}. Zum Ändern antippen. |
+| `respond.closed` | Closed: no more answers. | Geschlossen: keine weiteren Antworten. |
+| `respond.right` | Right! | Richtig! |
+| `respond.wrong` | Not quite. The right answer: {answer} | Leider nicht. Richtig ist: {answer} |
+| `respond.solution` | The right answer: {answer} | Richtig ist: {answer} |
+| `numeric.placeholder` | A number | Eine Zahl |
+| `numeric.invalid` | Enter a number, such as 0.5 or 1/2. | Eine Zahl eingeben, z. B. 0,5 oder 1/2. |
+| `numeric.sent` | Sent: {value}. Send another to change. | Gesendet: {value}. Zum Ändern eine andere senden. |
+| `numeric.other` | Other | Andere |
+| `numeric.right` | {n} right | {n} richtig |
 
 ---
 
@@ -685,23 +756,35 @@ For `play="auto"` the video pauses and resets to the beginning when you navigate
 | Attribute | Default | Description |
 |---|---|---|
 | `room` | `poll` | Name of the room that collects the answers; unique per poll in a deck. Letters, digits, `.`, `-`, `_` |
-| `options` | — | Answers separated by `\|` |
-| `question` | — | Question text; phones fall back to the slide heading |
+| `options` | — | Answers separated by `\|`. Markdown and `$…$` maths, as on a slide (see below) |
+| `question` | — | Question text, Markdown and maths like `options`; phones fall back to the slide heading |
 | `qr` | `true` | `false` leaves out the QR code (shown earlier with `<qrcode join />`) |
-| `answer` | — | The right answer (several separated by `\|`): a button with a tick outlines its label, bar and count in green, also in the audience window and on paired devices. `--poll-correct` sets the colour |
+| `answer` | — | The right answer (several separated by `\|`): a button with a tick outlines its label, bar and count in green, also in the audience window and on paired devices, and each phone says whether its vote was right. `--poll-correct` sets the colour |
+| `multiple` | — | Each phone may pick several options; the slide and the phones say so. A vote is then the list of options picked, and is right when it is exactly the `answer` options |
+| `buttons` | — | `letters` puts A, B, C … before the options, and the phones show only those; `numbers` does the same with 1, 2, 3 …. For options better read on the slide, such as pictures (`options="![](a.svg)\|![](b.svg)"`) |
+| `results` | — | `hidden` starts with the results hidden, e.g. for peer instruction. A button with an eye shows or hides them (bars and counts) at any time, also in the audience window and on paired devices. Hidden, the audience window shows no bars; the presenter's own screens show them faint |
 
-Three more activities take the same `room`, `question` and `qr`:
+Four more activities take the same `room`, `question` and `qr`:
 
 | Tag | Attributes | Phones | Slide |
 |---|---|---|---|
 | `<scale>` | `min` (1), `max` (5), `low`, `high` | One button per number, `low`/`high` as labels | Count per number and the average; latest answer per device |
+| `<numeric>` | `answer`, `tolerance` (0), `limit` (6), `placeholder`, `results` | A number field: `0.5`, `0,5`, `1/2`, `1e-3`; latest answer per device | The most frequent answers as bars, the rest as Other; with `answer`, the tick marks the right ones, counts them and tells each phone |
 | `<wordcloud>` | `placeholder`, `limit` (60), `height` (520) | Text field, up to 40 characters, repeatable | A packed word cloud (d3-cloud): size by frequency, some words upright, case-insensitive |
 | `<question>` | `placeholder`, `limit` (8) | Text field, up to 200 characters, repeatable | The newest answers as cards |
 
-`<qrcode join />` shows the deck's join code large with its link (`size`, default 420), for a slide that invites everyone once; activities after it can use `qr="false"`. QR codes (`<qrcode>`, activities) are SVG in the slide's `--ink` on a transparent background; `--qr-ink` and `--qr-bg` override the colours.
+`<qrcode follow />` shows the link for following the slides on phones and laptops (`?view=follow`), with `mdeck run --network` or a hosted deck with a `server` setting; the phones' answer page links to it as well. `<qrcode join />` shows the deck's join code large with its link (`size`, default 420), for a slide that invites everyone once; activities after it can use `qr="false"`. QR codes (`<qrcode>`, activities) are SVG in the slide's `--ink` on a transparent background; `--qr-ink` and `--qr-bg` override the colours.
+
+Options and the question may use Markdown and maths, e.g. `options="$2x$|$x^2$|$\frac{x^3}{3}$"`. A `|` inside a formula belongs to it (`$|x|$` is one option), and `\|` is a bar in plain text. The slide draws maths with KaTeX, the phones as MathML; votes and `answer` use the text as written. The other activities' `question`, and the scale's `low` and `high`, take Markdown and maths too.
 
 The slide shows live bars, the number of answers, a QR code and a short link. Phones never load the deck: they open the server's own answer page at `<server>/<code>`, where the six-digit session code is the same for every poll in the deck. The presenter's screen (the presenter view or a full deck window, never an embedded preview) announces the poll on the current slide with what the phones should show and the deck's look; the server only accepts that from the presenter. Between polls the phones wait. Each device's latest vote counts. The presenter can reset the room (hover over the results).
 
+Every activity has a lock button that closes it: answers after that do not count, and the phones say it is closed until it opens again. Polls and `<numeric>` also have the eye that hides or shows the results. Below the results, polls, scales and `<numeric>` count “12 of 31 answered” while phones are connected (people following the slides count as phones). The lock, the eye and the tick reach every screen of the talk, also after a reload: they are kept in the activity room's state on the server, which only the presenter may set, and phones read it there. Reset clears the answers and opens the activity again.
+
+While `mdeck run` runs, the answers are kept beside the deck in `<slides>.results.json`: per activity room, each answer with its time, the phones numbered per room (their ids are not kept), and, once an activity was closed, only the answers that counted. Reset takes a room out of the file; a new, empty server leaves the file alone. Builds, `mdeck send` and `mdeck pdf` show the kept answers where no room server answers (`--no-results` leaves them out), and `mdeck results [slides.md] [-o file.csv]` prints them as CSV: `room,phone,at,answer`, several picks joined by `|`.
+
+`--no-polls` leaves slides with an activity or a join code (`<qrcode join />`) out of `mdeck send`, `mdeck build --reader` and `mdeck pdf`; without it they show as a record of the talk. Saved drawings follow the remaining slides.
+
 Rooms run inside `mdeck run` (add `--network` so phones can reach it) or on a server started with `mdeck server`, set in the deck:
 
 ```yaml

package/docs/site/content/audience.md

@@ -28,19 +28,47 @@ Every poll in a presentation shows the same code, so people scan once. Their pho
 | Setting | Meaning |
 |---|---|
 | `room` | A short name for this question, different for each poll in the deck. Letters, digits, hyphens and underscores. |
-| `answer` | Optional: the right answer, written exactly like the option. A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and tapping again hides it. The audience window shows it too. |
+| `answer` | Optional: the right answer, written exactly like the option (several separated by `\|`). A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and each phone says whether its vote was right. Tapping again hides it. |
 | `options` | The answers, separated by `\|` |
 | `question` | Optional question text. Without it, phones show the slide's heading. |
+| `multiple` | Each phone may pick several options. The slide and the phones say “Several answers possible”. Without it, one option per phone. |
+| `buttons` | `letters` puts A, B, C … before the options on the slide, and the phones show only those letters; `numbers` does the same with 1, 2, 3 … For options that are pictures or long formulas, better read on the big screen. |
+| `results` | `hidden` starts with the bars hidden, e.g. to let people vote before they see what others chose. |
 | `qr` | `false` leaves out the QR code, when an earlier slide showed it with `<qrcode join />`. |
 
+The question and the options may contain formatting and formulas, written as on a slide, so a maths lecture can ask:
+
+```markdown
+<poll room="derivative" question="What is $\frac{d}{dx}\, x^2$?" options="$2x$|$x^2$|$\frac{x^3}{3}$" answer="$2x$" />
+```
+
+Both the slide and the phones show the formulas. A `|` inside a formula stays in it, so `$|x|$` is one option; to put a `|` in plain text, write `\|`.
+
+Options can also be pictures. Show only letters on the phones then:
+
+```markdown
+<poll room="graph" question="Which graph shows $f(x) = e^{-x}$?" options="![](a.svg)|![](b.svg)|![](c.svg)" answer="![](b.svg)" buttons="letters" />
+```
+
+### During the poll
+
+Below the bars, the slide counts the answers, “12 of 31 answered” while phones are connected. The presenter has three buttons there (the audience window does not show them):
+
+- **The lock** closes the poll. Answers after that do not count, and the phones say the poll is closed until you open it again.
+- **The eye** hides or shows the bars. Hidden, the audience sees no bars; your own screens show them faint.
+- **The tick** (with `answer`) shows the right answer: on the slide, and on each phone, which says whether its answer was right.
+
+Together they make a peer-instruction round: start with `results="hidden"`, let people vote, close, show the bars, let them discuss, and show the answer. **Reset** clears the answers and opens the poll again.
+
 With `lang: de` in the settings, the slide and the phones show German words, such as “Scannen und abstimmen”. The phones use the presentation's colours and fonts; if you pick another theme or palette in the presenter view, the phones change with it.
 
 ## Other kinds of questions
 
-Besides a poll, three more kinds work the same way: one line on a slide, answered on the phones.
+Besides a poll, four more kinds work the same way: one line on a slide, answered on the phones.
 
 ```markdown
 <scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />
+<numeric room="limit" question="What is $\lim_{x \to 0} \frac{\sin x}{x}$?" answer="1" />
 <wordcloud room="mood" placeholder="One word" />
 <question room="ask" placeholder="Your question" />
 ```
@@ -48,10 +76,11 @@ Besides a poll, three more kinds work the same way: one line on a slide, answere
 | Tag | Phones show | The slide shows |
 |---|---|---|
 | `<scale>` | The numbers from `min` to `max` (1 to 5 unless set, at most 11 steps), with `low` and `high` as labels at the ends | How many chose each number, and the average. Each phone's latest answer counts |
+| `<numeric>` | A field for a number: `0.5`, `0,5`, `1/2` or `1e-3` | The most frequent answers as bars, six unless `limit` says otherwise, and the rest as Other. With `answer`, the tick marks the right ones and counts them, and each phone hears whether it was right; `tolerance` (0 unless set) says how far off still counts. Each phone's latest answer counts |
 | `<wordcloud>` | A short text field | A cloud of every answer, packed around the middle, larger the more often it came in and some upright. Capitals and extra spaces do not matter. People may send several. `height` sets its height (520). Colours come from the palette; `--cloud-1` to `--cloud-6` override them |
 | `<question>` | A text field | The newest answers as cards, eight unless `limit` says otherwise. People may send several |
 
-All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields.
+All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields. Their `question`, and the scale's `low` and `high`, may contain formatting and formulas like a poll's options. All of them have the lock that closes them; `<numeric>` also has the eye and the tick, and takes `results="hidden"`.
 
 ## Show the code once
 
@@ -73,6 +102,12 @@ Each question shows the QR code unless you say otherwise. To invite everybody on
 
 The code is drawn in the slide's colours, so it fits the theme; phone cameras also read light codes on dark slides.
 
+### Follow the slides on a phone
+
+`<qrcode follow />` shows a code that opens your slides on people's phones and laptops, following you: the slide you show, step by step, and what you draw. They can page back to read something again and return with **Back to live**; slides you have not shown yet stay hidden. The phones' answer page links to it too (**Follow the slides**), so one join code can do both.
+
+It needs their devices to reach your slides: present with `mdeck run --network` when everyone is on the same Wi-Fi (it prints the **Follow** address), or host the built deck with a `server` setting for people anywhere.
+
 Hover over the results to see **Reset**, which clears the answers, for example before the real session. Only the presenter can reset.
 
 ## How phones and slides meet
@@ -169,9 +204,11 @@ Two presentations with the same title share a session code. Give one of them `se
 
 Answers are anonymous. Each phone gets a random number so it can change its vote; nothing else identifies it. The server keeps answers in memory only. It forgets a room after twelve hours without visitors and everything when it restarts. Each phone can send a limited number of answers in a short time.
 
+While you present with `mdeck run`, the answers are also kept beside the presentation, in `my-talk.results.json`. It holds each answer with its time, and the phones numbered 1, 2, 3 … per question instead of their random numbers. Once a question was closed, only the answers that counted. **Reset** takes a question's answers out of the file; a new server that starts empty leaves the file as it is. `mdeck results my-talk.md` prints the answers as CSV (question, phone, time, answer), to open in a spreadsheet; `-o answers.csv` saves them to a file. A deck hosted with its own `server` keeps nothing beside it.
+
 ## In a PDF or a shared file
 
-A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk: each shows its question and options, with a note that it was answered live, and no join code. If the deck's `server` still answers when the file is made or opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
+A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk, without a join code. With answers kept in `my-talk.results.json`, each shows its results as they were at the end of the talk; without, its question and options with a note that it was answered live. `--no-results` leaves the kept answers out. If the deck's `server` still answers when the file is opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
 
 ## Make your own activity
 

package/docs/site/content/commands.md

@@ -16,7 +16,8 @@ For how the commands, the views and the servers fit together, see [Views, comman
 | `mdeck palettes search`, `install <palette>`, … | The same for palettes |
 | `mdeck design [my-talk.md or folder]` | Look at themes and palettes on a sample deck and fine-tune them; saves to `extensions/` |
 | `mdeck migrate my-talk.md --dry-run` | Preview the changes needed for API 2.0 |
-| `mdeck check my-talk.md` | Check settings and look for missing local files |
+| `mdeck check my-talk.md` | Check settings and look for missing local files; `--render` also finds slides whose content does not fit |
+| `mdeck snapshot my-talk.md` | Save pictures of the slides as PNG files, for you or your assistant to look at |
 | `mdeck send my-talk.md` | Make one file to send to readers, with a PDF inside |
 | `mdeck build my-talk.md` | Make a folder to host in `dist` |
 | `mdeck pdf my-talk.md` | Make a PDF |
@@ -86,15 +87,18 @@ The design page shows themes and palettes on a sample deck with every kind of sl
 | Command | Result |
 |---|---|
 | `mdeck build my-talk.md` | A folder in `dist` with every view, to host or copy |
-| `mdeck build my-talk.md --reader` | A hosted reader folder with speaker notes removed; add `--notes` to retain them |
+| `mdeck build my-talk.md --reader` | A hosted reader folder with speaker notes removed; add `--notes` to retain them, `--no-polls` to leave out the slides with polls and their join codes |
 | `mdeck build my-talk.md -o talk.html` | Choose the output filename; local media stays alongside it |
 | `mdeck build my-talk.md --single-file -o talk.html` | Embed local images and media in one HTML file of the presentation |
 | `mdeck build my-talk.md --launchers` | Include presenter launchers in the folder build |
 | `mdeck send my-talk.md` | One file for readers: the reader view, speaker notes removed, a PDF inside |
 | `mdeck send my-talk.md --notes` | The same, keeping the speaker notes |
+| `mdeck send my-talk.md --no-polls` | The same, leaving out the slides with polls and their join codes |
 | `mdeck send my-talk.md --no-pdf` | The same, without rendering the PDF |
-| `mdeck pdf my-talk.md -o talk.pdf` | Render the slides to a PDF file |
+| `mdeck pdf my-talk.md -o talk.pdf` | Render the slides to a PDF file (`--no-polls` leaves out the slides with polls) |
 | `--no-drawings` | Leave out the drawings from `my-talk.drawings.json`, for `build`, `send` and `pdf` |
+| `--no-results` | Leave out the answers kept in `my-talk.results.json`, for `build`, `send` and `pdf`; the polls then show their questions only |
+| `mdeck results my-talk.md` | The answers kept during the talk, as CSV; `-o answers.csv` saves them to a file |
 
 See [Send, host or print your slides](sharing.html) for help choosing between them. Unknown options, missing option values and extra filenames stop the command before it changes any output. `--output=path` and `-o path` are both accepted. `mdeck preview --no-open --port 4200` previews without opening a browser and chooses a port.
 
@@ -117,7 +121,29 @@ mdeck check my-talk.md --strict
 
 The ordinary check fails when it finds an error. The strict check also fails when it finds a warning, such as a layout name it does not recognize.
 
-The check does not measure whether text fits on the slide. Always look through the preview too.
+## Check how the slides look
+
+```sh
+mdeck check my-talk.md --render
+```
+
+This builds the deck and shows every slide in Chrome, with all steps revealed as in a PDF. It reports, by slide, heading and line:
+
+- content that is taller than the slide's room for it;
+- text that is cut off at the slide's edge;
+- text that is hard to read on a plain background behind it;
+- errors the page reports, such as a component that fails.
+
+The check takes a few seconds and needs Chrome or Chromium; set `MDECK_CHROME` to its path if it is not found. It checks the deck in its own appearance. A slide with a problem it cannot measure, such as text on a photo, still needs a look in the preview.
+
+## Pictures of the slides
+
+```sh
+mdeck snapshot my-talk.md
+mdeck snapshot my-talk.md --slide 3,5-7 --dark
+```
+
+This saves each slide, with all steps revealed, as a 1280×720 PNG file in `.mdeck-snapshots/` beside the deck (`-o` for another folder), named `my-talk-03.png` and so on, and prints the paths. `--slide` picks slides by number; `--dark` and `--light` show that appearance instead of the deck's own. An AI assistant that reads pictures can use them to look at what it wrote. If you keep your slides in Git, add `.mdeck-snapshots/` to your `.gitignore`.
 
 ## Layouts, themes and palettes