进阶 sli.dev 2026-11-21 18:58:32 · 1 阅读

第8章 Slidev 幻灯片导出指南:CLI 与浏览器支持

导出

幻灯片通常在浏览器中展示,但你也可以把它们导出为 PDF、PPTX、PNG 或 Markdown 文件,方便分享或打印。这个功能通过 CLI 命令 slidev export 提供。

需要注意的是,幻灯片中的交互功能在导出后的文件里可能无法使用。如果想保留交互性,可以把幻灯片构建并部署为 Web 应用,详情见 Building and Hosting。

浏览器导出器(推荐)

此功能自 v0.50.0-beta.11 起可用。

Slidev 在浏览器中提供了导出界面。点击导航栏“更多选项”菜单中的"Export"按钮即可进入,也可以直接访问 http://localhost:/export。

在这个界面中,你可以把幻灯片导出为 PDF,或者将幻灯片截图为图片并打包下载成 PPTX 或 zip 文件。可编辑的 PPTX 只能通过 CLI 导出。

注意,非现代 Chromium 内核的浏览器可能无法正常使用这个导出界面。如果遇到问题,请改用 CLI。

本页接下来的内容仅针对 CLI。

CLI

导出 PDF、PPTX 或 PNG 依赖 Playwright 来渲染幻灯片,因此需要在项目中安装 playwright-chromium:

$ pnpm add -D playwright-chromium $ npm i -D playwright-chromium $ yarn add -D playwright-chromium $ bun add -D playwright-chromium $ deno add -D npm:playwright-chromium

格式

PDF

按照上述方式安装 playwright-chromium 之后,使用以下命令即可将幻灯片导出为 PDF:

$ slidev export

默认情况下,PDF 会输出到 ./slides-export.pdf。

PPTX

Slidev 也可以把幻灯片导出为 PPTX 文件:

$ slidev export --format pptx

注意:PPTX 中的每页幻灯片都会以图片形式导出,文字无法选中。演讲者备注会按页写入 PPTX 文件。

在此模式下,--with-clicks 选项默认开启,如需关闭,请传入 --with-clicks false。

可编辑 PPTX

如果接收方需要编辑幻灯片而不只是放映,可以导出为原生图形而非图片:

$ slidev export --format pptx-editable

幻灯片会在浏览器中完成度量,然后重建为 PowerPoint 原生图形,因此文字可以选中和编辑,文本框可以移动和改色,演讲者备注也会照常保留。这并不能取代 --format pptx——后者仍然是视觉还原度最高的选项。

以下内容仍会导出为图片:PowerPoint 没有对应实现的元素,包括 SVG(因此 Mermaid 图表和图标)、、