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
TITLEof 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.