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

第2章 入门指南:Slidev 幻灯片制作工具快速上手

入门指南

Slidev(/slaɪdɪv/)是一款基于 Web 的幻灯片制作与演示工具。它专为开发者设计,让他们专注于用 Markdown 编写内容。借助 Vue 等 Web 技术,你可以打造出像素级精准的视觉设计,并嵌入交互式演示。

提示:你可以深入了解本项目的开发初衷,参见 📖 为何选择 Slidev。

创建幻灯片

在线试用 通过 StackBlitz 直接在浏览器中启动 Slidev:sli.dev/new

本地创建 需要安装 Node.js >= 22.12.0。运行以下命令在本地创建新的 Slidev 项目:

  • pnpm create slidev
  • npm init slidev@latest (不推荐,因为 NPM 每次创建新项目时都会重新下载包,速度慢且占用空间大)
  • yarn create slidev
  • bun create slidev
  • deno init --npm slidev

按照提示操作即可开始幻灯片项目。幻灯片内容位于 slides.md 文件中,初始版本包含大部分 Slidev 特性的演示。关于 Markdown 语法的更多信息,请查阅 📖 语法指南。

单文件使用(不推荐) 如果你更喜欢使用单个 Markdown 文件作为幻灯片,可以全局安装 Slidev CLI:

  • pnpm i -g @slidev/cli
  • npm i -g @slidev/cli
  • yarn global add @slidev/cli
  • bun i -g @slidev/cli
  • deno i -g npm:@slidev/cli

然后,你可以通过以下命令创建并启动单文件幻灯片:slidev slides.md

基础命令

Slidev 的 CLI 提供了一组命令,以下是一些常用操作:

  • slidev:启动开发服务器。参见 dev 命令。
  • slidev export:将幻灯片导出为 PDF、PPTX 或 PNG。参见 📖 导出。
  • slidev build:将幻灯片构建成静态 Web 应用。参见 📖 托管。
  • slidev format:格式化幻灯片。参见 format 命令。
  • slidev --help:显示帮助信息

要在项目中使用这些命令,可以将它们添加到 package.json 的 scripts 中(如果项目是通过 npm init slidev 创建的,这一步已经自动完成):

{
  "scripts": {
    "dev": "slidev --open",
    "build": "slidev build",
    "export": "slidev export"
  }
}

这样,你就可以简单地运行 npm run dev、npm run build 和 npm run export。关于 CLI 的更多信息,请查阅 CLI 指南。

配置编辑器

由于 Slidev 使用 Markdown 作为源入口,你可以使用任何偏好的编辑器来创建幻灯片。我们还提供了一些工具,帮助你更便捷地编辑幻灯片:

  • ✨ VS Code 扩展
  • ✨ 集成编辑器
  • ✨ Prettier 插件

加入社区

推荐加入官方 Discord 服务器,获取帮助、分享你的幻灯片或讨论与 Slidev 相关的任何话题。如果遇到 Bug,欢迎在 GitHub 上提交 issue。

技术栈

Slidev 结合了以下工具和技术:

  • Vite:极快的前端构建工具
  • Vue 3 驱动的 Markdown:专注内容编写,必要时拥有 HTML 和 Vue 组件的强大能力
  • UnoCSS:按需的实用程序优先 CSS 框架,轻松美化幻灯片
  • Shiki, Monaco Editor:一流的代码片段支持,具备实时编码功能
  • RecordRTC:内置录制和摄像头视图
  • VueUse 系列:@vueuse/core, @vueuse/head, @vueuse/motion 等
  • Iconify:图标库集合
  • Drauu:绘图和注释支持
  • KaTeX:LaTeX 数学公式渲染
  • Mermaid:文本图表

评论 (0)