进阶 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