导出 PDF
演示文稿最终要交付给观众或归档，PDF 是通用性最强的格式。Slidev 提供 CLI 导出命令，一条命令即可生成高质量 PDF。
slidev export 命令
在项目根目录执行：
bash
slidev export默认生成 slides-export.pdf 到当前目录，包含全部幻灯片。
常用基本参数：
| 参数 | 说明 |
|---|---|
--output | 指定输出文件名/路径 |
--format | 导出格式（默认 pdf） |
--range | 导出指定页范围 |
--with-clicks | 将点击步骤拆成多页 |
--timeout | 页面渲染超时时间 |
--wait | 页面加载后等待时长 |
安装 Playwright Chromium
导出依赖 Playwright 驱动的无头浏览器渲染。首次运行若提示缺少浏览器，执行：
bash
npx playwright install chromium安装完成后即可正常导出。国内网络下载较慢时可配置镜像或耐心等待。
--with-clicks 导出动画步骤
默认 PDF 每张幻灯片只有最终形态。若想保留点击动画的每个步骤，加 --with-clicks：
bash
slidev export --with-clicks效果：
- 每触发一次点击（v-click 等）就生成一页
- 一页幻灯片有 3 步动画，导出后就是 3 页
- 适合需要逐步讲解、打印讲义的场景
适合评审材料、教学讲义——读者能逐步看到内容的展开逻辑。
--range 范围导出
只需部分页面时用 --range：
bash
slidev export --range 1,3,5-8| 写法 | 含义 |
|---|---|
1 | 只导出第 1 页 |
5-8 | 导出第 5 到 8 页 |
1,3,5-8 | 组合：第 1、3、5-8 页 |
注意：范围以幻灯片页为单位，与 --with-clicks 拆出的步骤页不同，两者组合时需先理解分页规则。
常用组合示例
bash
# 全量导出，保留动画步骤
slidev export --with-clicks
# 只导出第 2-5 页，保留步骤，命名自定义
slidev export --range 2-5 --with-clicks --output handout.pdf
# 导出指定主题风格的 PDF
slidev export --theme seriph与 Frontmatter 配合
导出文件名可在 Frontmatter 中预设：
yaml
---
exportFilename: my-slides
---之后 slidev export 默认输出 my-slides.pdf，无需每次指定 --output。
常见问题
| 问题 | 处理 |
|---|---|
| 提示缺少 Chromium | 执行 npx playwright install chromium |
| 导出内容空白 | 加长 --timeout，或检查是否有异步内容未加载 |
| 字体/图标缺失 | 确认网络可访问，或把资源本地化 |
| 动画步骤丢失 | 确认已加 --with-clicks |
使用建议
- 交付评审：全量导出含步骤 PDF，逻辑清晰
- 归档备份：最终版导出 PDF 长期保存，不依赖构建环境
- 打印讲义：
--with-clicks拆分步骤，配合--range按章节打印
导出 PDF 是 Slidev 交付链路的第一环，配合后续的 PPTX/PNG 与浏览器导出，覆盖全部主流分发场景。