Exporting #

Slides #

PDF #

Exporting to PDF or PNG relies on Playwright for rendering. You will therefore need to install playwright-chromium to use this feature. If you are doing exporting in a CI environment, the playwright CI guide can be helpful.

Install playwright-chromium

$ npm i -D playwright-chromium

Now export your slides to PDF using the following command

$ kolibry export

After a few seconds, your slides will be ready at ./slides-export.pdf.

PNGs and Markdown #

When passing in the --format png option, Kolibry will export PNG images for each slide instead of a PDF.

$ kolibry export --format png

You can also compile a markdown file composed of compiled png using --format md.

$ kolibry export --format md

Dark mode #

In case you want to export your slides using the dark version of the theme, use the --dark option:

$ kolibry export --dark

Export Clicks Steps #

By default, Kolibry exports one page per slide with clicks animations disabled. If you want export slides with multiple steps into multiple pages, pass the --with-clicks option.

$ kolibry export --with-clicks

Slide range #

You can also specify a range of slides to export with the --range option.

$ kolibry export --range 1,4-5,6

PDF outline #

You can generate the PDF outline by passing the --with-toc option.

$ kolibry export --with-toc

Output filename #

You can specify the output filename with the --output option.

$ kolibry export --output my-pdf-export

Or in the frontmatter configuration:

---
exportFilename: my-pdf-export
---

Export a range of slides #

By default, all slides in the presentation are exported. If you want to export a specific slide or a range of slides you can set the --range option and specify which slides you would like to export.

$ kolibry export --range 1,6-8,10

This option accepts both specific slide numbers and ranges.

The example above would export slides 1,6,7,8, and 10.

Multiple entries #

You can also export multiple slides at once.

$ kolibry export slides1.md slides1.md

Or

$ kolibry export *.md

In this case, each input file will generate its own PDf file.

Presenter notes #

Export only the presenter notes (the last comment block for each slide) into a text document in PDF.

$ kolibry export-notes

This command also accept multiple entries like for the export command

Single-Page Application (SPA) #

See Static Hosting.

Troubleshooting #

Timeout #

For big presentation you might want to increase the playwrigth timeout with --timeout

$ kolibry export --timeout 60000

Executable path #

You can set the browser executable path for playwright using --executable-path

$ kolibry export --executable-path [path_to_chromium]