Presentation mode
Presentation mode turns a document into a full-screen slideshow, one slide at a time.
Presentation mode is part of Twain Pro.
Starting and stopping
With a document open, choose View ▸ Present Slides (⌥⌘P). Twain takes the window full screen and shows the first slide. Press Esc to exit; the window returns to its previous size.
Slides follow the Appearance setting (System, Light or Dark), but not the rest of the reading settings. The Sepia and High Contrast themes, the serif reading font, the reading width and the text size set with ⌘= and ⌘- do not apply: slides use their own fixed layout and type scale.
How slides are divided
Twain splits the document into slides at each horizontal rule. In Markdown you write a horizontal rule as a line of three or more dashes, asterisks, or underscores:
# First slide
Some content.
---
# Second slide
More content.
A leading frontmatter block (fenced by ---) does not create a slide; only rules within the body
do. Its title and any key/value rows are still rendered, as a card at the top of the first slide.
A document with no horizontal rules becomes a single slide, and consecutive rules do not produce blank slides: an empty group is skipped.
Moving between slides
| Key | Action |
|---|---|
| →, ↓, Space, Page Down | Next slide |
| ←, ↑, Page Up | Previous slide |
| Home | First slide |
| End | Last slide |
| Esc | Exit presentation |
A counter shows your position, for example 3 / 12.
What a slide shows
Slides go through the same render pipeline as the reading view, so maths, Mermaid diagrams, callouts and syntax highlighting all appear. A few things differ, because the presentation window renders without the document's folder context:
- Local images do not load on slides, whether the path is relative (
) or absolute. Use a remote URL for an image that has to appear in a presentation. - A component map (
.twain-md.json) is not applied, so mapped MDX components fall back to the labelled placeholder they show when no map is in force. - Remote images (those with an
https:source) always load on slides, even if you have turned off Load Remote Images in the reading settings menu.