Skip to content

export

Export your presentation as a PDF or a PPTX file.

slidesk export mytalk               # mytalk.pdf
slidesk export -t pptx mytalk       # mytalk.pptx
slidesk export -o slides.pdf mytalk
slidesk export -n mytalk            # with the speaker notes

Options

  -t, --type <format>        pdf or pptx (default: "pdf")
  -o, --output <file>        output file (default: the slugified title of your talk)
  -c, --conf <file>          custom slidesk.toml path
  -l, --lang <code>          language version
  -n, --notes                add a page with the speaker notes after each slide (pdf)
  -T, --theme <name>         use only this theme, when the talk has several

Requirements

Exporting renders your slides in a headless Chromium, driven by Bun.WebView over the DevTools Protocol — an already installed browser is used, nothing is downloaded. Chrome, Chromium, Edge, Brave and Vivaldi are detected automatically, as is Playwright's chrome-headless-shell when it is installed; set SLIDESK_CHROME (or CHROME_PATH) to point at a specific binary:

SLIDESK_CHROME=/usr/bin/chromium slidesk export mytalk

Without any of them, the lightest to install is chrome-headless-shell:

bunx playwright install chromium-headless-shell

On macOS, a Chromium is not needed: without one, the export uses the WebKit of the system. The pptx is the same, but the pdf is made of one image per page, without selectable text, links or bookmarks.

What you get

Slides are rendered at 1920x1080.

  • pdf — one page per slide, and per step it reveals, printed vectorially: text stays selectable and searchable, and the file stays small. Each slide title is a bookmark, to jump to a slide from the side panel of the reader, and the document is named after the TITLE of the talk. With --notes, the /* ... */ speaker notes of a slide follow its last step, on as many pages as they need; slides without notes get no extra page.
  • pptx — one PowerPoint slide per slide, and per step it reveals, each holding a full-bleed 1920x1080 capture of the rendered slide. Your /* ... */ speaker notes are exported as plain text into the PowerPoint notes pane.

Both formats go through the talk exactly like presenting, pressing "next" from the first slide to the last: each slide is captured as it renders when you land on it, so plugin onSlideChange hooks fire and the elements they inject are exported too. A step-by-step plugin, such as @gouz/steps or @gouz/sbs, reveals one item per "next": each reveal is captured as a page of its own, so the export shows the slide as the audience saw it, step after step. The notes of a slide go with each of its steps in the pptx. Transitions are dropped.

A slide is captured once the TRANSITION delay (300 ms by default) has elapsed; raise it in slidesk.toml if a plugin needs longer to draw.

The PDF is printed in one go at the end, so a slide is snapshotted while it is current and put back just before printing — plugins that tear down their output when you leave a slide (abcjs drops its score, xterm its terminal) still export correctly. A slide is only put back if it actually changed, and never if it holds an <iframe>, whose loaded document cannot be re-created: such a slide is printed once, in its last state, even with steps.