Slidev 基本命令

Slidev 的全部操作都通过 slidev 命令行完成。在项目目录（含 slides.md）执行 slidev 相关命令即可。

开发服务器

slidev

启动本地开发服务器，默认端口 3030，浏览器访问 http://localhost:3030 预览。特点：

• 热更新：保存 slides.md 后页面即时刷新
• 终端交互：终端显示快捷键提示（全屏、概览、演讲者模式等）
• 退出：终端按 Ctrl+C

启动时指定其他入口文件：

slidev slides.md
slidev docs/other-deck.md

构建静态站点

slidev build

将演示文稿构建为可部署的静态 SPA，产物输出到 dist/ 目录（可用 --out 修改）。构建产物可直接托管到 GitHub Pages、Netlify、Vercel 等任意静态服务器。部署到子路径时配合 --base 指定基础路径。

导出多种格式

slidev export

导出为 PDF（默认）。导出依赖 Chromium（自动安装 Playwright），首次导出会下载浏览器内核。常用导出参数：

slidev export --format pdf      # 导出 PDF（默认）
slidev export --format pptx     # 导出 PPTX
slidev export --format png      # 每张幻灯片导出 PNG 图片
slidev export --with-clicks     # 包含点击动画的每一帧
slidev export --range 1-5       # 只导出第 1 到 5 页
slidev export --output slides   # 指定输出文件名

格式化

slidev format

对 slides.md 中的代码块执行格式化，使代码风格统一。Slidev 的代码块会交给 Prettier 处理（与项目级格式化器协同）。也可以指定格式化目标：

slidev format slides.md
slidev format slides.md code.md  # 格式化多个文件

常用参数一览

参数	简写	作用
--open	-o	启动后自动打开浏览器
--port <number>	-p	指定开发服务器端口（默认 3030）
--remote		远程访问模式（如 --remote 或 --remote my-password）
--theme <name>	-t	指定主题（也可在 Frontmatter 配置）
--out <dir>		构建/导出输出目录（默认 dist）
--base <path>		部署基础路径（子目录部署时使用）
--format <fmt>		导出格式：pdf/pptx/png/md
--range <pages>		导出指定页范围，如 1-5,8
--with-clicks		导出时包含动画步骤
--without-notes		构建产物中去除演讲者备注
--help	-h	查看帮助
--version	-v	查看版本

命令速查表

命令	功能
slidev	启动开发服务器（默认 3030 端口）
slidev slides.md	指定入口文件启动
slidev build	构建静态站点到 dist/
slidev export	导出 PDF（含动画步骤用 --with-clicks）
slidev export --format pptx	导出 PPTX
slidev export --format png	逐页导出图片
slidev format	格式化代码块
slidev --open --port 8080	指定端口并自动打开浏览器