第2章 入门指南:Slidev 幻灯片制作工具快速上手
入门指南
Slidev(/slaɪdɪv/)是一款基于 Web 的幻灯片制作与演示工具。它专为开发者设计,让他们专注于用 Markdown 编写内容。借助 Vue 等 Web 技术,你可以打造出像素级精准的视觉设计,并嵌入交互式演示。
提示:你可以深入了解本项目的开发初衷,参见 📖 为何选择 Slidev。
创建幻灯片
在线试用 通过 StackBlitz 直接在浏览器中启动 Slidev:sli.dev/new
本地创建 需要安装 Node.js >= 22.12.0。运行以下命令在本地创建新的 Slidev 项目:
pnpm create slidevnpm init slidev@latest(不推荐,因为 NPM 每次创建新项目时都会重新下载包,速度慢且占用空间大)yarn create slidevbun create slidevdeno init --npm slidev
按照提示操作即可开始幻灯片项目。幻灯片内容位于 slides.md 文件中,初始版本包含大部分 Slidev 特性的演示。关于 Markdown 语法的更多信息,请查阅 📖 语法指南。
单文件使用(不推荐) 如果你更喜欢使用单个 Markdown 文件作为幻灯片,可以全局安装 Slidev CLI:
pnpm i -g @slidev/clinpm i -g @slidev/cliyarn global add @slidev/clibun i -g @slidev/clideno 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:文本图表