Concepts

Navigation

Linear by default, with an opt-in 2D grid. The mouse navigates too, and yields to scrollable content.

Linear by default

Out of the box navigation is linear: the arrow keys move to the next / previous slide (or reveal step), wherever you are. Adding a <deck-section> does not change that on its own.

The mouse navigates too (since 0.3.0): click to advance, Shift+click to go back, the scroll wheel, the bottom-right chevrons, and the mouse back/forward buttons. The wheel yields to scrollable content (a tall code block, a zoomable SVG): it scrolls that element and only advances the deck once it reaches the scroll edge. Scope or disable it with the mouse-nav attribute.

2D navigation (opt-in)

Add nav="2d" to <deck-root> (with two or more <deck-section> chapters) to opt into a reveal.js-style grid where the axes split apart. Without it, arrows stay linear, so adding a section never silently remaps ← / →.

Overview mode

Press O to open a path-style overview: one row per chapter, sub-slides flow rightward, the current slide is highlighted. Click any thumbnail to jump there. Press Esc or O again to close.

The overview module is lazy-loaded · the JS and CSS fetch on first O. Same for the help overlay below.

Help overlay

Press ? or H for the full keyboard cheatsheet. The list adapts to whether 2D nav applies in the current deck.

URL hash

The canonical URL is #N · slide N (1-indexed, flat). Share #5 and the deck opens on slide 5; #5.2 opens it at step 2. With nav="2d", #chapter.slide coordinates are also accepted. Out-of-range links are clamped to the nearest valid slide and step (never reset to slide 1), so a bookmarked link survives while you edit the deck.

The bottom-left hint

Rikiki shows a small keyboard cheatsheet in the bottom-left corner: it always lists ← →, O, P, ? · and adds ↑ ↓ when nav="2d" is active. The chips are clickable shortcuts for the matching action.