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

第3章 Slidev Markdown 语法指南

语法指南 Slidev 的幻灯片由 Markdown 文件编写,称为 Slidev Markdown。一个演示文稿以一个 Slidev Markdown 文件作为入口,默认为 ./slides.md,但你可以通过向 CLI 命令传递文件路径参数来更改。 在 Slidev Markdown 中,除了可以像往常一样使用基础 Markdown 功能外,Slidev 还提供了额外的特性来增强你的幻灯片。本节介绍 Slidev 引入的语法。请确保在阅读本文前已熟悉基础 Markdown 语法。 幻灯片分隔符 使用前后带有空行的 --- 来分隔幻灯片: ``` # Title Hello, Slidev! --- # Slide 2 Use code blocks for highlighting: ```ts console.log('Hello, World!') ``` --- # Slide 3 Use UnoCSS classes and Vue components to style and enrich your slides:
Frontmatter 与 Headmatter 每张幻灯片的开头可以添加可选的 frontmatter 来配置幻灯片。第一块 frontmatter 叫做 headmatter,用于配置整个幻灯片组,其余的则用于配置各自的幻灯片。headmatter 和 frontmatter 中的内容应为 YAML 格式的对象。例如:md--- theme: seriph title: Welcome to Slidev --- # Slide 1 这张幻灯片的 frontmatter 同时也是 headmatter --- layout: center background: /background-1.png class: text-white --- # Slide 2 使用 `center` 布局和背景图片的页面 --- # Slide 3 没有 frontmatter 的页面 --- src: ./pages/4.md # 这张幻灯片只包含 frontmatter --- --- # Slide 5 可以设置的配置项见「幻灯片组配置」和「单张幻灯片配置」章节。 为了让 headmatter 更易读,可以安装 VSCode 扩展:✨ VS Code Extension 此外还支持另一种 frontmatter 格式:✨ Block Frontmatter 备注 你还可以为每张幻灯片创建演讲者备注,它们会显示在 📖 用户界面中,方便演讲时参考。 每张幻灯片末尾的注释块会被视为该幻灯片的备注:md--- layout: cover --- # Slide 1 这是封面页。 --- # Slide 2 第二页 备注中支持基本的 Markdown 和 HTML,并会正常渲染。另见:✨ Click Markers 代码块 创建 Slidev 的一个重要原因,就是需要在幻灯片中完美展示代码。因此你可以使用 Markdown 风格的代码块来高亮代码:md```ts console.log('Hello, World!') ``` Slidev 内置了 Shiki 作为语法高亮器,详见「配置 Shiki」。 更多关于代码块的内容: ✨ Line Numbers ✨ Max Height ✨ Line Highlighting ✨ Monaco Editor ✨ Monaco Runner ✨ Writable Monaco Editor ✨ Shiki Magic Move ✨ TwoSlash Integration ✨ Import Code Snippets ✨ Code Groups LaTeX 块 Slidev 支持用 LaTeX 块书写数学和化学公式:✨ LaTeX 图表 Slidev 支持 Mermaid 和 PlantUML,可以用文本创建图表:✨ Mermaid Diagrams ✨ PlantUML Diagrams Comark 语法 Comark Syntax 是为元素应用样式和类名的最简单方式:✨ Comark Syntax Scoped CSS 可以使用 scoped CSS 来美化幻灯片:✨ Slide Scope Styles 导入幻灯片 ✨ Importing Slides

评论 (0)