Export Slidev presentations as a PDF with speaker notes — like PowerPoint's "Notes Page" view.
Each page of the PDF contains two slides stacked vertically, each with its rendered speaker notes alongside.
Slidev's built-in export-notes command exports notes as text only — this tool gives you the slide images alongside your notes for a complete rehearsal document. Useful for:
- Reviewing your talk with notes visible
- Sharing a presentation with collaborators who need the context
- Printing a rehearsal copy
npm install --save-dev slidev-export-notesOr run directly:
npx slidev-export-notesRun from inside any Slidev project directory (where your slides.md lives):
npx slidev-export-notesThis will:
- Start the Slidev dev server automatically
- Screenshot each slide
- Render your speaker notes as formatted HTML
- Produce a PDF with two slides per page, notes alongside each
- Shut down the server
Output: slides-notes.pdf in your project directory.
| Option | Description | Default |
|---|---|---|
-s, --slides <file> |
Path to slides markdown file | slides.md |
-o, --output <file> |
Output PDF filename | slides-notes.pdf |
-p, --port <number> |
Port for Slidev dev server | 3030 |
-z, --size <size> |
Page size: letter or a4 |
letter |
-V, --version |
Show version | |
-h, --help |
Show help |
Both of Slidev's note syntaxes are supported:
HTML comment syntax:
## My Slide
Content here
<!--
Speaker notes go here.
They support **markdown** formatting.
-->Triple-colon syntax:
## My Slide
Content here
:::
Speaker notes go here.
They support **markdown** formatting.
:::- Node.js 18+
- A Slidev project with
slidevas a dependency
The tool parses your slides.md to extract note blocks, launches Playwright to screenshot each rendered slide from the dev server, composes an HTML layout with the slide images and rendered notes, then prints it to PDF. Notes text is auto-fitted to the available space.
MIT
