Export to PDF or PPTX
Hand out your deck, upload it to a conference platform, or drop it into a PowerPoint agenda.
slidesk export my-talk # my-talk.pdf
slidesk export -t pptx my-talk # my-talk.pptx
The output file is named after the TITLE of your slidesk.toml (slugified),
or after the talk directory. Override it with -o:
slidesk export -o build/deck.pdf my-talk
Install a browser
Exporting needs a Chromium-based browser: SliDesk starts it headless through
Bun.WebView and drives it over the DevTools Protocol. Chrome, Chromium, Edge,
Brave and Vivaldi are found automatically. Nothing is downloaded and no extra
dependency is installed.
Without one, the lightest to install is chrome-headless-shell, found
automatically too:
bunx playwright install chromium-headless-shell
On macOS, nothing is needed: without a Chromium, SliDesk exports with the WebKit of the system. The PPTX is the same, but each page of the PDF is then an image, without selectable text, links or bookmarks.
If your browser lives somewhere unusual — or in CI:
SLIDESK_CHROME=/usr/bin/chromium slidesk export my-talk
In a GitHub Actions job:
- run: bunx playwright install chromium-headless-shell
- run: bunx slidesk export -t pdf my-talk
PDF or PPTX?
| pptx | ||
|---|---|---|
| Slide rendering | vectorial | 1920x1080 image |
| Selectable text | yes | no |
| Speaker notes | with --notes, as pages |
yes, in the notes pane |
| Bookmarks | one per slide | no |
| File size | small | a few MB |
| Editable afterwards | no | slide order and notes |
Pick pdf to share or archive a deck, pptx when someone asks for "the PowerPoint".
Language versions
Export the version you need with -l, like when presenting:
slidesk export -l fr my-talk -o deck-fr.pdf
slidesk export -l en my-talk -o deck-en.pdf
What does not survive the export
Both formats walk the deck like a speaker pressing "next", so plugin
onSlideChange hooks run for every slide and whatever they render ends up in
the export. Step-by-step reveals (@gouz/steps, @gouz/sbs) are unrolled: one
page per revealed item. What gets lost:
- transitions between slides are dropped,
- anything driven by interaction is frozen in its initial state.
One case the PDF cannot cover: a slide holding an <iframe> keeps the frame it
loaded and is never rebuilt, because an iframe re-created at print time would
come out blank. If a plugin renders into such a slide and tears it down when
you leave, only the last visited one keeps its content. Export that deck as
PPTX, which captures every slide while it is on screen.
Speaker notes
Your /* ... */ notes land in the notes pane of the PPTX, one PowerPoint note
per slide, repeated on each of its steps — slides without notes get none. Notes are exported as plain text:
formatting is dropped, list items keep a • marker, and blank lines are
preserved.
The PDF carries them with --notes: after the last step of each slide comes a
page with its notes, formatting kept, on as many pages as they need. Slides
without notes get no extra page.
slidesk export -n my-talk