Presenting a Folder

A folder of HTML pages is already a slide deck. Right-click it, choose Present, and DocGraph plays its pages one after another, full screen, in the order the file tree shows them. There is no export and no separate slides file: the pages you edit are the slides.

Try it first

The demo vault has a Slide Deck folder built for this. Right-click it and choose Present. If you opened the demo vault before this feature existed, the folder is added to your copy the next time you open it — and if you delete it, it stays deleted.

Starting a deck

There are two ways in:

• Right-click a folder → Present. The deck starts on the first slide, opened as a tab — or the tab you already have for it. Your other tabs stay exactly as they were.
• Command palette (⌘K) → Present folder of current file. With a slide already open, the deck starts on that slide, in place — handy for picking up where you left off.

DocGraph goes full screen and hides everything except the page. If full screen is refused, the deck still runs in the window, and Esc still ends it.

Which pages become slides

• Only HTML pages sitting directly in the folder — .html and .htm. Markdown notes, PDFs, stylesheets and images in the folder are skipped, and so is everything inside subfolders. That is deliberate: your notes, assets and drafts can live beside the slides without appearing in the talk.
• In file-tree order. Pages sort alphabetically until you drag them; after that, the deck follows your custom order. Drag a page up in the tree and its slide moves up.
• A folder with no HTML pages directly inside it has no Present entry, in the menu or the palette.

Slides are shown read-only, at full width, without the backlinks footer — whatever mode the page was open in before.

While presenting

Key	Does
→, Space, Page Down	Next slide
←, Backspace, Page Up	Previous slide
Home / End	First / last slide
P	Open the presenter view
Esc	Stop presenting

The keys work whether the focus is on the app or inside the slide itself. The one exception is a text field inside a slide, which keeps its own typing keys.

Move the mouse and a small bar appears at the bottom: previous and next buttons, the slide number and title, the presenter view, and an exit button. Point at the slide number (or tab to it) to list every slide, and click one to jump to it. The bar fades away again while you talk.

Stepping past the last slide shows an End of deck card rather than leaving — ← goes back, Esc exits. When you stop, the slide you ended on stays open as a normal tab.

A link inside a slide that points at another slide of the same deck keeps the deck in step, so the slide number stays right.

If one of the deck’s pages is open in a separate window, starting the deck closes that window first (saving anything unsaved), and while the deck runs its pages can’t be moved into a window of their own.

Slide transitions respect your system’s Reduce motion setting.

Speaker notes

A slide’s speaker notes are a section of the page headed Speaker notes. The heading and everything under it are your notes: you see them in the presenter view, and the audience never does.

To add notes, type / in Inline mode and choose Speaker notes (in the Blocks group). It adds the heading and a placeholder line (“Notes”) under it — select the placeholder and type over it. You can also type the heading yourself: any heading, of any level, whose text is Speaker notes works, whatever its capitals.

Notes are ordinary content, so they hold what a talk needs and edit like the rest of the page:

• Lists, bulleted or numbered, with nesting (the presenter view shows up to four levels; deeper items join the fourth). Type - or 1. at the start of a line. Tab and Shift+Tab indent and outdent an item.
• Bold, italic and code, with the usual shortcuts or Markdown (**bold**).
• A divider — type --- on its own line. The presenter view shows it as a line across the notes, a good “pause here” mark.
• Code blocks — type three backticks at the start of a line.
• A smaller heading inside the notes (a level 3 heading under a level 2 Speaker notes) is shown as a line of notes text.

Links, highlights and other formatting are kept on the page but shown as plain text in the presenter view.

Where the notes end

The notes run from the Speaker notes heading to the next heading of the same or a higher level, or to the end of the element the heading sits in — for most slides, the end of the slide. Two things follow:

• Keep the notes last on the slide. Anything after the notes in the same container is part of the notes, and is hidden while presenting. A footer belongs above the notes; the demo deck puts its footers there. To put slide content after the notes, start it with a heading of the same level.
• A slide whose real title is “Speaker notes” is treated as notes, and that content is not shown on the slide.

A slide can have more than one notes section; the presenter view shows them in page order. Put the notes heading directly in the slide’s own element or in the page body — a notes heading inside a list item or a table cell whose end tag is left out has no clear end, and its notes run to the next heading.

While presenting, notes are never shown on the slide. Outside a presentation the page shows them like any other content, under their heading, which folds like any other section when collapsible headings are on. Notes are part of the page, so they also appear in the outline, in search and in a PDF export.

The presenter view

Press P while presenting (or use the bar’s presenter-view button) to open a second window that only you see.

It shows:

• The slide number and title.
• Your notes for the current slide, with their lists and formatting. Beside the Notes label, ≈ 0:40 is about how long they take to read aloud at 150 words a minute; it turns red when the slide has a planned time and the notes would take longer. A− and A+ (or the [ and ] keys) make the notes text smaller or larger, and the size is remembered on this computer.
• The next slide, as a live preview with its title — or the end of the deck.
• The clocks — see Timing your talk.
• Controls: previous, pause, next, and End presentation.

With more than one screen, the presenter view opens on a different screen from the one you present on. The same slide keys work in either window. Esc in the presenter view closes only that window — ending the talk takes the End presentation button, so a stray key can’t stop your presentation. When the deck ends, the presenter view closes with it.

Timing your talk

The presenter view keeps two clocks:

• Talk — time since the deck started.
• Slide — time on the current slide. It starts again every time you arrive on a slide, including when you come back to one.

Each reads actual / planned once there is a plan, with a small bar underneath.

Setting the plan

The whole talk: click the Talk label in the presenter view. Pick a length — 10, 15, 20, 30, 45, 60 or 90 minutes — or type minutes and press Set. No plan removes it. The choice is saved on the folder as a deck-minutes property, so it’s there next time. You can also set deck-minutes from the folder’s Properties panel before you present.

One slide: give that page a slide-minutes property — for example 1.5 for a minute and a half.

How the two combine:

• A slide with its own slide-minutes keeps that time.
• The other slides share what’s left of the talk evenly. Their plan is marked shared.
• If the slides’ own times add up to more than the talk, the talk length is kept, the shared slides get 0:00, and the presenter view shows a warning.
• With no talk length, only slides with their own time have a plan, and the talk clock simply counts up.

Both values take a positive number of minutes, and decimals work. A value that isn’t a number is ignored, and the presenter view names the page or folder it came from.

Reading the clocks

• A clock turns amber at 80% of its plan and red at 100%.
• Beside the talk clock, ahead, on pace or behind compares where you are in the talk with where this slide was planned to be. The shaded band on the talk bar marks that window.
• Pause stops both clocks; press it again to resume.
• Restart — click the talk clock, then click it again within three seconds. The first click only asks; Esc or any other control cancels.

A plan set from the Talk label takes effect straight away. A timing property changed some other way while you present, for example by the AI, is picked up at the next slide.

Limits

• HTML pages only, and only those directly in the folder. There is no way to include a subfolder’s pages or a Markdown note as a slide.
• The presenter view shows notes’ lists, bold, italic, code and dividers; links and other formatting show as plain text, a table in the notes shows as lines of text, and images are not shown.
• The single-page Presentation mode described in Reading & Presenting is separate: it shows one page full screen and has no slides, notes or clocks.