用途:该技能用于将 Slidev 演示文稿导出为 PDF、PPTX、PNG 或 Markdown,便于在不运行 Slidev 的情况下分享、打印、制作讲义和归档。
主要能力:支持浏览器导出(自 v0.50.0 起内置)和 CLI 导出。浏览器方式为运行演示后从导航栏打开 Export 面板,或访问 http://localhost:3030/export,选择格式与选项后导出。CLI 方式需先安装 playwright-chromium:npm install -D playwright-chromium,然后执行 npx slidev export。
导出格式:PDF 输出 ./slides-export.pdf;PPTX 用 npx slidev export --format pptx,输出 ./slides-export.pptx,幻灯片以图片形式导出并包含演讲者备注;PNG 用 npx slidev export --format png,输出到 ./slides-export/ 目录;Markdown 用 npx slidev export --format md,生成内嵌 PNG 图片的 Markdown。
常用选项:--format(pdf、pptx、png、md)、--output 自定义名称、--dark 暗色模式、--with-clicks 将每次点击导出为单独页面、--range 指定幻灯片范围(如 --range 1,4-5,8)、--timeout 超时(如 60000)、--wait 等待时间、--wait-until 页面加载策略(none、load、domcontentloaded、networkidle)、--with-toc 生成 PDF 目录、--format png --omit-background 去除透明背景、--scale 2 提高分辨率。
frontmatter 配置:可用 exportFilename 指定导出文件名;download: true 显示下载按钮;download: 'https://example.com/slides.pdf' 链接到预生成 PDF。
限制与注意:导出不包含动画,仅导出每页最终状态,需用 --with-clicks 捕捉各步骤;视频和 iframe 导出效果差,建议改用截图;字体可能无法渲染,建议使用 Web 字体或嵌入字体;代码高亮需 Shiki 先加载,可用 --wait;图片缺失时可使用绝对 URL 或放入 public/ 目录;出现超时可用 npx slidev export --timeout 120000 --wait 5000;内存不足可用 NODE_OPTIONS="--max-old-space-size=4096" npx slidev export。导出与构建不同,导出为静态文件且无交互,构建为可交互静态网站。