语法指南
Slidev 的幻灯片以 Markdown 文件编写,称为 Slidev Markdown。演示文稿由一个 Slidev Markdown 作为入口点,该文件默认为 ./slides.md,你可以将文件路径作为参数传递给 CLI 命令 来使用别的文件。
在 Slidev Markdown 中,不仅可以像平常一样使用 基本的 Markdown 功能,Slidev 还提供了额外的功能来增强你的幻灯片。本节介绍了 Slidev 引入的语法。请确保你了解基本的 Markdown 语法后再阅读本指南。
幻灯片分隔符
使用在两侧留有空行的 --- 来分隔幻灯片:
# Title
你好,**Slidev**!
---
# Slide 2
使用代码块进行高亮:
```ts
console.log('Hello, World!')
```
---
# Slide 3
使用 UnoCSS 类和 Vue 组件来为幻灯片添加样式和丰富内容:
<div class="p-3">
<Tweet id="..." />
</div>Frontmatter 与 Headmatter
在每张幻灯片的开头,你可以添加一个可选的 frontmatter 来配置幻灯片。第一个 frontmatter 块称为 headmatter,可以配置整个幻灯片项目。其余的是单张幻灯片的 frontmatters。headmatter 或 frontmatter 中的文本应该是 YAML 格式的对象。例如:
---
theme: seriph
title: Welcome to Slidev
---
# 第一页
第一页的 frontmatter 也是整个演示文稿的 headmatter
---
layout: center
background: /background-1.png
class: text-white
---
# 第二页
本页的布局是 `center`,背景是一张图片
---
# 第三页
本页没有 frontmatter
---
src: ./pages/4.md # 本页只包含 frontmatter
---
---
# 第五页你可以设置的配置项在 幻灯片项目配置 和 单张幻灯片配置 章节中描述。
为了使 headmatter 更易读,你可以安装 VSCode 扩展:
还可以使用另一种 frontmatter 格式:
演讲者备注
你还可以为每张幻灯片创建演讲者备注。它们会在 📖 用户界面 中显示,供你在演讲时参考。
每张幻灯片末尾的注释块被视为该幻灯片的备注:
---
layout: cover
---
# 第一页
封面页
<!-- 这是一条 **备注** -->
---
# 第二页
<!-- 这不是备注,因为它不在幻灯片的末尾 -->
第二页的内容
<!--
这是 _另一条_ 备注
-->备注中也支持渲染 Markdown 和 HTML。
代码块
创建 Slidev 的一个重要原因是需要在幻灯片中完美地显示代码。因此,你可以使用 Markdown 风格的代码块来高亮你的代码。
```ts
console.log('Hello, World!')
```Slidev 内置了 Shiki 作为语法高亮器。有关更多详情,请参阅 配置 Shiki。
更多关于代码块的内容:
LaTeX 块
Slidev 支持 LaTeX 块来编写数学和化学公式:
图表
Slidev 支持使用 Mermaid 和 PlantUML 从文本创建图表:
MDC 语法
MDC 语法是为元素应用样式和类的最简单方式:
Scoped CSS
Scoped CSS 可以用来为你的幻灯片添加样式: