slidev-pdf-export

name	slidev-pdf-export
description	Fix Slidev presentation PDF export issues: slides not filling the page, black margins, broken backgrounds, zoom/scale problems, and content clipping. Use when working with Slidev, slidev export, PDF generation from slides, or when the user mentions slides not fitting the page, black bars in PDF, or content overflow in presentations.

Slidev PDF Export

Project-local copy. Canonical source: C:\Users\koldo\.cursor\skills\slidev-pdf-export\SKILL.md

Quick rules for this repo

1. Always export with npm run export (uses slidev export --per-slide).
2. Never add global .slidev-layout { overflow-y: auto } — use html:not(.print) scope (see style.css).
3. Keep background and layout: cover in the same frontmatter block (see thank-you slide).
4. Put per-slide zoom: inside --- YAML blocks, not after speaker notes.
5. Do not override html.print scaling — breaks Mermaid and cover backgrounds.

Commands

npm run export              # PDF, full-page per slide
slidev export --per-slide --with-toc
slidev export --per-slide --dark

Dense slides

If content clips in PDF, add per-slide frontmatter:

---
zoom: 0.86
---

See full heuristics in the canonical skill file above.