mdeck 3.6.1 → 3.7.0

package/docs/site/content/welcome.md

@@ -6,6 +6,74 @@ The content stays yours. The assistant works from your material, not from its ow
 
 [Make your first presentation](getting-started.html)
 
+## What you can do with it
+
+<div class="features">
+
+<section>
+
+[![The presenter view on an iPad with circles, an arrow and a highlight drawn on a chart slide, and the projector behind it showing the same strokes](images/features/drawing.webp)](images/features/drawing.webp)
+
+### Draw on your slides, from an iPad if you like
+
+Circle a number, underline a phrase, point with a laser. Pair an iPad by scanning a code, and it becomes your presenter screen and drawing pad while the laptop drives the projector: every stroke shows on the big screen as you draw. Drawings are kept with the talk, in its PDF too. [Draw on your slides](drawing.html)
+
+</section>
+
+<section>
+
+[![A poll slide with live bars and a QR code, and a phone showing the same question with one answer picked](images/features/polls.webp)](images/features/polls.webp)
+
+### Ask the room, and show the answers on the slide
+
+Polls, scales, word clouds, open questions and numbers to guess. People scan the code and answer on their phones, no app needed, and the bars grow as votes come in. Close the vote, discuss, reveal the right answer. The answers are kept with the talk. [Ask your audience](audience.html)
+
+</section>
+
+<section>
+
+[![A slide with author–year citations and the full references at its foot, next to a slide that lists all references](images/features/citations.webp)](images/features/citations.webp)
+
+### Cite your sources properly
+
+Cite as in a paper, `[@knuth1984, p. 97]`, from the BibTeX, CSL-JSON or Hayagriva file you already keep. Each slide lists what it cites at its foot, and a references slide lists everything, in APA, Vancouver, Harvard or any CSL style. [Cite a source](more-content.html#cite-a-source)
+
+</section>
+
+<section>
+
+[![The same chart slide in six themes: neue, plain, work, academic, minimal and glass](images/features/themes.webp)](images/features/themes.webp)
+
+### Write the content once, change the look anytime
+
+The file holds what you say; a theme and a palette decide how it looks. One line changes every slide, light or dark, and your text never moves. Six themes come with mdeck, more are one command away in the [theme repository](https://gh.tschieber.de/mdeck-themes/). [Change the look](appearance.html)
+
+</section>
+
+<section>
+
+[![A slide with a short Python example and its output below it](images/features/code.webp)](images/features/code.webp)
+
+### Run code on the slide
+
+Give a Python or JavaScript example a Run button, change it in front of the audience and run it again. Python runs right in the browser, with packages such as NumPy and pandas, so nothing needs installing. [Show a code example](more-content.html#show-a-code-example)
+
+</section>
+
+<section>
+
+[![The reader view of a talk on a laptop, with an outline of the slides, and on a phone in reading mode](images/features/reader.webp)](images/features/reader.webp)
+
+### Send one file that anyone can open
+
+`mdeck send` makes a single HTML file for the people you send the talk to: an outline, a reading mode for phones, light and dark, and the PDF inside. It opens in any browser, also offline, and your speaker notes stay out. [Send, host or print](sharing.html)
+
+</section>
+
+</div>
+
+Also: a presenter view with notes, timer and the next slide; points revealed one at a time; pictures, videos and formulas; a browser editor for those who prefer clicking; and a launch page (`mdeck run`) that gathers it all, with a check for missing pictures and slides that do not fit.
+
 <!-- preview -->
 
 ## Bring your material, then shape it
@@ -52,13 +120,9 @@ The `#` makes a heading. The line with `---` starts another slide. A dash before
 - **Which view or server do I need?** See [Views, commands and servers](views.html).
 - **Something looks wrong?** Try [the troubleshooting guide](troubleshooting.html).
 
-## What mdeck does today
-
-mdeck gives you ready-made slide layouts, different visual themes, speaker notes, pictures, videos, a separate presenter view, drawing on slides (also from an iPad), polls and other questions your audience answers on their phones, and a reader view with a PDF for people you send the slides to. It can also use layouts, themes and colors made for your team, and your assistant can make new ones for a single talk.
-
-`mdeck run` opens a launch page for your talk with all of this in one place: the presenter view, the editor, these guides, buttons that make the files to share, and a check for missing pictures.
+## Your file, whoever edits it
 
-Whoever writes the slides, your assistant, a text editor, or the built-in browser editor (`mdeck edit`), the file stays the single copy, and the preview updates as it changes.
+Whoever writes the slides, your assistant, a text editor, or the built-in browser editor (`mdeck edit`), the file stays the single copy, and the preview updates as it changes. mdeck can also use layouts, themes and colours made for your team, and your assistant can make new ones for a single talk.
 
 ## Keep this guide nearby
 

package/docs/site/examples/chart.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 820 900"><rect width="820" height="900" fill="var(--surface, #f2f2f2)"/>
+<g stroke="var(--rule, #ddd)" stroke-width="2"><path d="M60 760H780"/><path d="M60 585H780"/><path d="M60 410H780"/><path d="M60 235H780"/></g>
+<rect x="90" y="550" width="70" height="210" rx="5" fill="var(--muted, #888)"/><rect x="205" y="480" width="70" height="280" rx="5" fill="var(--muted, #888)"/><rect x="320" y="130" width="70" height="630" rx="5" fill="var(--accent, #888)"/><rect x="435" y="410" width="70" height="350" rx="5" fill="var(--muted, #888)"/><rect x="550" y="550" width="70" height="210" rx="5" fill="var(--muted, #888)"/><rect x="665" y="620" width="70" height="140" rx="5" fill="var(--muted, #888)"/>
+<g fill="var(--muted, #666)" font-family="sans-serif" font-size="30" text-anchor="middle"><text x="125" y="815">A</text><text x="240" y="815">B</text><text x="355" y="815">C</text><text x="470" y="815">D</text><text x="585" y="815">E</text><text x="700" y="815">F</text></g>
+</svg>

package/docs/site/examples/first-talk.drawings.json

@@ -0,0 +1 @@
+{"version":1,"width":1920,"height":1080,"slides":{"draw":[{"id":"peak","tool":"pen","color":"#e11d48","size":7,"points":[[427,193,0.45],[434,188,0.47],[443,182,0.48],[453,178,0.5],[464,175,0.52],[476,174,0.54],[487,173,0.55],[499,175,0.57],[510,177,0.59],[520,181,0.6],[530,186,0.62],[538,191,0.63],[546,197,0.65],[553,203,0.66],[559,209,0.67],[564,216,0.69],[569,223,0.7],[573,230,0.71],[577,237,0.72],[580,245,0.73],[581,252,0.74],[582,261,0.75],[581,269,0.76],[579,277,0.77],[575,285,0.78],[569,293,0.78],[561,299,0.79],[553,305,0.79],[543,309,0.79],[533,312,0.8],[522,314,0.8],[511,315,0.8],[501,315,0.8],[491,315,0.8],[481,314,0.8],[471,312,0.79],[461,311,0.79],[452,309,0.79],[443,307,0.78],[433,304,0.78],[424,301,0.77],[415,297,0.76],[407,292,0.75],[400,286,0.74],[394,280,0.73],[389,272,0.72],[386,265,0.71],[385,257,0.7],[386,249,0.69],[388,241,0.67],[391,233,0.66],[396,226,0.65],[401,220,0.63],[407,214,0.62],[414,209,0.6],[421,204,0.59],[428,199,0.57],[436,194,0.55],[444,190,0.54],[453,186,0.52],[463,182,0.5],[473,179,0.48],[484,177,0.47],[496,176,0.45]]},{"id":"arrow","tool":"pen","color":"#e11d48","size":7,"points":[[600,215,0.45],[615,215,0.49],[630,215,0.53],[644,215,0.57],[659,215,0.61],[674,216,0.64],[689,218,0.67],[704,220,0.7],[719,223,0.73],[733,226,0.75],[748,230,0.77],[763,236,0.79],[778,242,0.79],[793,249,0.8],[807,257,0.8],[822,266,0.79],[837,275,0.79],[852,286,0.77],[867,298,0.75],[881,310,0.73],[896,323,0.7],[911,337,0.67],[926,352,0.64],[941,367,0.61],[956,382,0.57],[970,398,0.53],[985,414,0.49],[1000,430,0.45]]},{"id":"arrow-head","tool":"pen","color":"#e11d48","size":7,"points":[[967,421,0.45],[1000,430,0.8],[993,397,0.45]]}]}}

package/docs/site/examples/first-talk.md

@@ -1,20 +1,41 @@
 ---
-theme: academic
+theme: neue
+meta:
+  title: "A short tour of mdeck"
 show:
   organization: none
   author: none
----
-
+bibliography: references.bib
 ---
 :::meta
 layout: title
+image: ./mdeck.svg
+fit: contain
+alt: "A Markdown file turning into a stack of slides"
 id: hello
 :::
-# Write it down.
-## Why every lab keeps a notebook
+# Slides from a text file.
+## A short tour of mdeck
+
+:::notes
+These notes are only for you: they show in the presenter view.
+:::
+
+---
+:::meta
+id: how-it-works
+:::
+# From your material to a talk
+
+:::steps
+- Hand your slides, papers or notes to an AI assistant
+- It writes one Markdown file with your content
+- mdeck presents it in the browser
+- Send it as one file, or as a PDF
+:::
 
 :::notes
-Ask who has ever repeated an experiment because nobody remembered how it was done.
+Press Next: the points appear one at a time.
 :::
 
 ---
@@ -22,67 +43,136 @@ Ask who has ever repeated an experiment because nobody remembered how it was don
 layout: split
 props:
   ratio: [1, 1]
+id: write-this
 :::
-# A notebook answers three questions.
+# Write this, get a slide
+
+:::slot left
+```markdown
+# Three ideas
 
-- What did I do?
-- What did I see?
-- What would I change?
+- Start small
+- Show an example
+- Ask a question
+```
+:::
 
-:::notes
-Everything else in a good notebook serves one of these three questions.
+:::slot right
+A `#` makes the heading, a dash a point, and `---` starts the next slide. Your assistant writes it; you can read and change every word.
 :::
 
 ---
 :::meta
 layout: focus
-attribution: "A saying in many labs"
 :::
-# If it is not written down, it did not happen.
+# Your talk is a text file: you can read it, change it and keep it.
 
 ---
+
 :::meta
 layout: chapter
 number: 1
-part: "Good habits"
+part: "In the room"
 :::
-# Write as you work.
+# Present it, live.
 
-Two habits that make a notebook useful a year later.
+Draw, ask the room, cite and run code, right on the slides.
 
 ---
 :::meta
-layout: split
-props:
-  ratio: [1, 1]
+layout: image-text
+image: ./chart.svg
+alt: "A bar chart with one bar much taller than the others"
+id: draw
 :::
-# Two habits that pay off
+# Draw while you talk
 
-:::slot left
-## Date every page
-The date and the experiment's name come first, before anything else.
+- Circle, underline, point with a laser
+- From an iPad paired with the laptop
+- Saved with the slide, also in the PDF
+
+:::notes
+The circle and the arrow were drawn on this slide and stay with it.
 :::
 
-:::slot right
-## Record what went wrong
-Failed runs explain the successful ones. Never tear out a page.
+---
+:::meta
+id: first
+:::
+# Which will you try first?
+
+<poll room="first" options="Drawing on slides|Polls from phones|Citations|A new theme" />
+
+:::notes
+People answer on their phones and the bars grow live. These answers are kept from a talk.
 :::
 
 ---
 :::meta
-layout: image-text
-image: ./notebook.svg
-alt: "An open lab notebook with written steps, a results table and a plot"
+id: cite
 :::
-# One page per experiment
+# Cite like in a paper
 
-Aim, materials, steps, results and a short conclusion. Glue in printouts so nothing gets lost.
+Slides are Markdown, a plain text format meant to read well as it is [@gruber2004]. Text and code kept together is an old idea [@knuth1984].
+
+Citations use Pandoc's syntax [@pandoc] and any citation style; each slide lists its references at its foot.
+
+---
+:::meta
+id: references
+:::
+# References
+
+<bibliography />
+
+---
+:::meta
+id: run
+:::
+# Run code on the slide
+
+```python live editable
+features = ["drawing", "polls", "citations", "themes"]
+print(", ".join(name.capitalize() for name in features))
+```
+
+:::tip
+Press Run, change the list, run it again.
+:::
+
+---
+:::meta
+layout: chapter
+number: 2
+part: "The look"
+:::
+# Content and style, apart.
+
+The file holds what you say. A theme decides how it looks.
+
+---
+:::meta
+layout: split
+props:
+  ratio: [1, 1]
+:::
+# One file, many looks
+
+:::slot left
+## Themes
+Six come with mdeck, more are one command away. Try the pictures below this deck.
+:::
+
+:::slot right
+## Light or dark
+Every palette has both. Switch while presenting, without touching the file.
+:::
 
 ---
 :::meta
 layout: full-bleed-image
-image: ./notebook.svg
-alt: "An open lab notebook with written steps, a results table and a plot"
+image: ./contours.jpg
+alt: "Contour lines like those on a map"
 overlay: true
 :::
-# Your future self will thank you.
+# Make your next presentation.

package/docs/site/examples/first-talk.results.json

@@ -0,0 +1,171 @@
+{
+  "version": 1,
+  "rooms": {
+    "first": {
+      "savedAt": "2026-10-09T09:13:00.000Z",
+      "closed": false,
+      "answers": [
+        {
+          "phone": 1,
+          "at": "2026-10-09T09:12:00.000Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 2,
+          "at": "2026-10-09T09:12:01.700Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 3,
+          "at": "2026-10-09T09:12:03.400Z",
+          "value": "Citations"
+        },
+        {
+          "phone": 4,
+          "at": "2026-10-09T09:12:05.100Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 5,
+          "at": "2026-10-09T09:12:06.800Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 6,
+          "at": "2026-10-09T09:12:08.500Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 7,
+          "at": "2026-10-09T09:12:10.200Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 8,
+          "at": "2026-10-09T09:12:11.900Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 9,
+          "at": "2026-10-09T09:12:13.600Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 10,
+          "at": "2026-10-09T09:12:15.300Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 11,
+          "at": "2026-10-09T09:12:17.000Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 12,
+          "at": "2026-10-09T09:12:18.700Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 13,
+          "at": "2026-10-09T09:12:20.400Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 14,
+          "at": "2026-10-09T09:12:22.100Z",
+          "value": "Citations"
+        },
+        {
+          "phone": 15,
+          "at": "2026-10-09T09:12:23.800Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 16,
+          "at": "2026-10-09T09:12:25.500Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 17,
+          "at": "2026-10-09T09:12:27.200Z",
+          "value": "Citations"
+        },
+        {
+          "phone": 18,
+          "at": "2026-10-09T09:12:28.900Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 19,
+          "at": "2026-10-09T09:12:30.600Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 20,
+          "at": "2026-10-09T09:12:32.300Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 21,
+          "at": "2026-10-09T09:12:34.000Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 22,
+          "at": "2026-10-09T09:12:35.700Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 23,
+          "at": "2026-10-09T09:12:37.400Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 24,
+          "at": "2026-10-09T09:12:39.100Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 25,
+          "at": "2026-10-09T09:12:40.800Z",
+          "value": "A new theme"
+        },
+        {
+          "phone": 26,
+          "at": "2026-10-09T09:12:42.500Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 27,
+          "at": "2026-10-09T09:12:44.200Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 28,
+          "at": "2026-10-09T09:12:45.900Z",
+          "value": "Citations"
+        },
+        {
+          "phone": 29,
+          "at": "2026-10-09T09:12:47.600Z",
+          "value": "Polls from phones"
+        },
+        {
+          "phone": 30,
+          "at": "2026-10-09T09:12:49.300Z",
+          "value": "Drawing on slides"
+        },
+        {
+          "phone": 31,
+          "at": "2026-10-09T09:12:51.000Z",
+          "value": "Citations"
+        },
+        {
+          "phone": 32,
+          "at": "2026-10-09T09:12:52.700Z",
+          "value": "Polls from phones"
+        }
+      ]
+    }
+  }
+}

package/docs/site/examples/mdeck.svg

@@ -0,0 +1,66 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="800" viewBox="0 0 960 800">
+  <!-- A Markdown file becoming a stack of slides. The colours come from the
+       deck's palette (var(--accent) …), so the picture follows the theme;
+       the fallbacks apply where it is shown as a plain image. -->
+  <style>
+    .mdk-paper { fill: var(--surface, #eef1fb); stroke: var(--rule, #d5dbf0); stroke-width: 3; }
+    .mdk-fold { fill: var(--rule, #d5dbf0); }
+    .mdk-shadow { fill: var(--ink, #0c1033); opacity: .12; }
+    .mdk-code { font-family: ui-monospace, 'JetBrains Mono', Menlo, Consolas, monospace; font-size: 30px; fill: var(--ink-soft, #2a2f55); }
+    .mdk-mark { fill: var(--accent, #1f3fd1); font-weight: 700; }
+    .mdk-quiet { fill: var(--muted, #5b6080); }
+    .mdk-slide { fill: var(--bg, #ffffff); stroke: var(--ink, #0c1033); stroke-width: 3; }
+    .mdk-accent { fill: var(--accent, #1f3fd1); }
+    .mdk-accent-2 { fill: var(--accent-2, #e8590c); }
+    .mdk-rule { fill: var(--rule, #d5dbf0); }
+    .mdk-on-accent { fill: var(--on-accent, #ffffff); font-family: var(--font-display, sans-serif); font-weight: 800; font-size: 96px; }
+    .mdk-title { fill: var(--ink, #0c1033); font-family: var(--font-display, sans-serif); font-weight: 800; font-size: 46px; }
+    .mdk-arrow { fill: none; stroke: var(--accent-2, #e8590c); stroke-width: 5; stroke-linecap: round; stroke-linejoin: round; }
+  </style>
+
+  <!-- The text file -->
+  <g transform="rotate(-5 230 400)">
+    <rect class="mdk-shadow" x="56" y="146" width="370" height="510" rx="18"/>
+    <path class="mdk-paper" d="M58 130 h290 l62 62 v438 a18 18 0 0 1 -18 18 h-316 a18 18 0 0 1 -18 -18 v-482 a18 18 0 0 1 18 -18 z"/>
+    <path class="mdk-fold" d="M348 130 v44 a18 18 0 0 0 18 18 h44 z"/>
+    <text class="mdk-code" x="84" y="232"><tspan class="mdk-mark">#</tspan> A talk</text>
+    <text class="mdk-code" x="84" y="300"><tspan class="mdk-mark">-</tspan> one idea</text>
+    <text class="mdk-code" x="84" y="344"><tspan class="mdk-mark">-</tspan> an example</text>
+    <text class="mdk-code mdk-mark" x="84" y="412">---</text>
+    <text class="mdk-code mdk-quiet" x="84" y="480">:::notes</text>
+    <text class="mdk-code mdk-quiet" x="84" y="524">pause here</text>
+    <text class="mdk-code mdk-quiet" x="84" y="568">:::</text>
+  </g>
+
+  <!-- From text to slides -->
+  <path class="mdk-arrow" d="M300 112 C 380 20, 560 22, 640 150" stroke-dasharray="2 16"/>
+  <path class="mdk-arrow" d="M612 138 l30 16 l4 -34"/>
+  <path class="mdk-accent" d="M470 60 l7 17 l17 7 l-17 7 l-7 17 l-7 -17 l-17 -7 l17 -7 z"/>
+  <path class="mdk-accent-2" d="M760 210 l5 12 l12 5 l-12 5 l-5 12 l-5 -12 l-12 -5 l12 -5 z"/>
+
+  <!-- The slides: a chapter, a statement, and a content slide in front -->
+  <g transform="rotate(9 680 330)">
+    <rect class="mdk-accent-2" x="440" y="200" width="480" height="270" rx="14"/>
+  </g>
+  <g transform="rotate(3 660 420)">
+    <rect class="mdk-accent" x="420" y="290" width="480" height="270" rx="14"/>
+    <text class="mdk-on-accent" x="452" y="386">2</text>
+    <rect class="mdk-accent-2" x="512" y="350" width="80" height="10" rx="5"/>
+  </g>
+  <g transform="rotate(-3 640 540)">
+    <rect class="mdk-shadow" x="412" y="420" width="480" height="270" rx="14"/>
+    <rect class="mdk-slide" x="400" y="404" width="480" height="270" rx="14"/>
+    <text class="mdk-title" x="432" y="470">A talk</text>
+    <rect class="mdk-accent" x="432" y="486" width="88" height="8" rx="4"/>
+    <rect class="mdk-accent" x="432" y="524" width="14" height="14" rx="3"/>
+    <rect class="mdk-rule" x="458" y="525" width="150" height="12" rx="6"/>
+    <rect class="mdk-accent" x="432" y="562" width="14" height="14" rx="3"/>
+    <rect class="mdk-rule" x="458" y="563" width="120" height="12" rx="6"/>
+    <rect class="mdk-accent" x="432" y="600" width="14" height="14" rx="3"/>
+    <rect class="mdk-rule" x="458" y="601" width="136" height="12" rx="6"/>
+    <rect class="mdk-accent-2" x="682" y="580" width="34" height="62" rx="4"/>
+    <rect class="mdk-accent" x="726" y="530" width="34" height="112" rx="4"/>
+    <rect class="mdk-accent-2" x="770" y="556" width="34" height="86" rx="4"/>
+    <rect class="mdk-accent" x="814" y="500" width="34" height="142" rx="4"/>
+  </g>
+</svg>

package/docs/site/examples/references.bib

@@ -0,0 +1,23 @@
+@misc{gruber2004,
+  author = {Gruber, John},
+  title = {Markdown},
+  howpublished = {Daring Fireball},
+  year = {2004},
+  url = {https://daringfireball.net/projects/markdown/}
+}
+@article{knuth1984,
+  author = {Knuth, Donald E.},
+  title = {Literate Programming},
+  journal = {The Computer Journal},
+  volume = {27},
+  number = {2},
+  pages = {97--111},
+  year = {1984},
+  doi = {10.1093/comjnl/27.2.97}
+}
+@misc{pandoc,
+  author = {MacFarlane, John},
+  title = {Pandoc: A Universal Document Converter},
+  year = {2006},
+  url = {https://pandoc.org/}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.6.1",
+  "version": "3.7.0",
   "type": "module",
   "description": "Write slides as a plain text file, present them in the browser, share them as one HTML file or PDF.",
   "license": "MIT",
@@ -54,7 +54,8 @@
     "playground": "vite --config playground/vite.config.js",
     "playground:build": "vite build --config playground/vite.config.js",
     "readme-images": "node tools/readme-images.mjs",
-    "theme-images": "node tools/theme-images.mjs"
+    "theme-images": "node tools/theme-images.mjs",
+    "feature-images": "node tools/feature-images.mjs"
   },
   "dependencies": {
     "@citation-js/core": "^0.9.0",

package/skills/write-slides/SKILL.md

@@ -142,7 +142,7 @@ To see slides yourself, if you can read pictures, run `mdeck snapshot <deck>.md
 
 When the user wants a look the built-in themes and palettes do not give (their institute's colours, a font, the style of a poster or picture), first run `mdeck themes search` or `mdeck palettes search` (with a word or two): someone may have shared it, and `mdeck themes install <theme> <deck>.md` (with its palette) or `mdeck palettes install <palette> <deck>.md` puts it beside the deck, so the slide folder carries it. Otherwise make it as an extension in `extensions/` beside the deck, never as styling on single slides. Read `extensions.md` from the reference folder first; it lists every setting.
 
-- **Colours only: a palette.** `extensions/<id>/extension.toml` with `kind = "palette"`, and every colour role (`--bg`, `--surface`, `--ink`, `--ink-soft`, `--muted`, `--rule`, `--accent`, `--accent-2`, `--on-accent`) in both `[light]` and `[dark]`. Text colours must stay readable on `--bg` and `--surface` in both variants, because themes use the other variant for inverted slides.
+- **Colours only: a palette.** `extensions/<id>/extension.toml` with `kind = "palette"`, and every colour role (`--bg`, `--surface`, `--ink`, `--ink-soft`, `--muted`, `--rule`, `--accent`, `--accent-2`, `--accent-3`, `--on-accent`) in both `[light]` and `[dark]`: `--accent` is emphasis, `--accent-2` its companion, `--accent-3` attention (warnings; it may be too light for text, such as a yellow). Set all of them. Text colours must stay readable on `--bg` and `--surface` in both variants, because themes use the other variant for inverted slides.
 - **Fonts, sizes, spacing or arrangement: a theme.** Copy the folder of the closest built-in theme (`assets/extensions/themes/<id>/` in the mdeck repository or in `$(npm root -g)/mdeck/`) to `extensions/<new-id>/`, change `id` and `title`, then its tokens and `styles.css`. A theme takes no colours of its own: it names its default `palette`, and the colours come from palettes.
 - **Use it:** set `theme:` and `palette:` in the deck settings. `mdeck list <deck>.md` must show it as local, and `mdeck check <deck>.md` reports any mistake in its `extension.toml`.
 - **Hand over:** tell the user to run `mdeck design <deck>.md` (or `mdeck design <folder>` when there is no deck yet). It shows the look on a sample deck with every kind of slide, light and dark, and lets them fine-tune colours, fonts and sizes there.

package/src/build/check.js

@@ -26,6 +26,7 @@ export function checkDeck(slidesPath, registry, source = readFileSync(slidesPath
   for (const record of Object.values(registry.palettes)) {
     if (record.source !== 'local') continue
     for (const problem of paletteProblems(record.manifest)) diagnostics.push({ severity: 'warning', code: 'palette-contrast', message: `Palette "${record.id}", ${problem}`, line: 1, column: 1 })
+    for (const role of record.manifest.fallbacks ?? []) diagnostics.push({ severity: 'warning', code: 'palette-fallback', message: `Palette "${record.id}" sets no ${role}, so it gets mdeck's amber; give it a colour of its own in [light] and [dark]`, line: 1, column: 1 })
   }
   // The deck's drawings file: readable, and only for slides that still exist.
   const inkPath = inkFileFor(resolve(slidesPath))