references/core-exporting.md

GitHub
nameexporting
descriptionExport presentations to PDF, PPTX, PNG, or Markdown

Exporting Slides

Export presentations to PDF, PPTX, PNG, or Markdown.

Browser Exporter

Access at http://localhost:3030/export:

  • Select format and options
  • Preview and download

CLI Export

Requires playwright:

pnpm add -D playwright-chromium

PDF Export

slidev export
slidev export --output my-slides.pdf

PowerPoint Export

slidev export --format pptx

PNG Export

slidev export --format png
slidev export --format png --range 1-5

Markdown Export

slidev export --format md

Export Options

With Click Steps

Export each click as separate page:

slidev export --with-clicks

Dark Mode

slidev export --dark

Slide Range

slidev export --range 1,4-7,10

Table of Contents

PDF with clickable outline:

slidev export --with-toc

Timeout

For slow-rendering slides:

slidev export --timeout 60000

Wait

Wait before capture:

slidev export --wait 2000

Wait Until

Wait condition:

slidev export --wait-until networkidle   # Default
slidev export --wait-until domcontentloaded
slidev export --wait-until load
slidev export --wait-until none

Transparent Background

slidev export --omit-background

Custom Browser

slidev export --executable-path /path/to/chrome

Headmatter Options

---
exportFilename: my-presentation
download: true              # Add download button in build
export:
  format: pdf
  timeout: 30000
  withClicks: false
---

Troubleshooting

Missing Content

Increase wait time:

slidev export --wait 3000 --timeout 60000

Wrong Global Layer State

Use --per-slide or use slide-top.vue instead of global-top.vue.

Broken Emojis

Use system fonts or install emoji font on server.

CI/CD Export

Install playwright browsers:

npx playwright install chromium