全栈攻城狮

Appearance

自定义配置 ​

Slidev 的配置集中在 Frontmatter（headmatter）中，一套 YAML 即可控制主题、代码、公式、录制、编辑器等全部行为。掌握配置项，演示文稿的可塑性直接翻倍。

配置入口 ​

全局配置写在 slides.md 顶部的 Frontmatter：

yaml
---
title: My Slides
theme: seriph
lineNumbers: true
---

页级配置写在每页分隔符 --- 后的 Frontmatter 中，只对当前页生效。

核心配置项一览 ​

配置项说明示例
theme主题名seriph
layout默认布局default
title文档标题My Slides
info描述信息分享说明
lineNumbers代码行号true
highlighter高亮器shiki
transition幻灯片过渡slide-left
colorSchema颜色模式auto
fonts字体配置sans: Noto Sans SC
exportFilename导出文件名my-slides
base部署基础路径/repo/
drauu绘图配置color: #f00
recordrtc录制配置type: video

shiki 配置 ​

代码高亮由 Shiki 驱动，可配置语言与主题：

yaml
---
highlighter: shiki
shiki:
  theme: github-dark
  langs:
    - ts
    - java
---
配置项说明
theme高亮配色（github-dark / vitesse-dark 等）
langs加载的编程语言集合
highlighter可选 shiki 或 prism

katex 配置 ​

公式渲染使用 KaTeX，可关闭或调整：

yaml
---
katex: true
---
  • katex: true（默认）启用 $...$ 与 $$...$$ 公式
  • 设为 false 关闭 KaTeX，公式按普通文本显示
  • 更多 KaTeX 渲染参数按需扩展

recordrtc 配置 ​

控制录制行为：

yaml
---
recordrtc:
  type: video
  frameRate: 30
---
配置项说明
typevideo 或 audio
frameRate录制帧率

monaco 配置 ​

Monaco 编辑器全局开关与选项：

yaml
---
monaco: true
monacoTypesIgnorePackages: true
---
配置项说明
monaco启用 Monaco 编辑器（true 或 false）
monacoTypesIgnorePackages忽略未安装的类型包，避免报错

启用后即可在代码块中使用 ```monaco、```monaco-run、```monaco-diff。

其他常用配置 ​

yaml
---
titleTemplate: '%s - Slidev'
colorSchema: dark
defaults:
  layout: center
  transition: fade
css: unocss
---
配置项说明
titleTemplate浏览器标题模板
colorSchemalight / dark / auto
defaults所有页的默认 Frontmatter
css样式引擎（unocss 等）

配置优先级 ​

  • 页级 Frontmatter 覆盖全局 Frontmatter
  • defaults 提供中间层默认值
  • 命令行参数（如 --base）优先于配置文件

使用建议 ​

  • 集中管理：全局配置放顶部，页级差异放页内
  • 先查文档：不确定的配置项对照官方文档确认取值
  • 最小改动：按需开启特性，避免无谓的体积与复杂度

headmatter 是 Slidev 的「控制面板」，把主题、代码、公式、录制、编辑器都收进一份 YAML，改配置即改全局行为。