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

第29章 配置字体

配置字体

虽然你完全可以用 HTML 和 CSS 自由定制幻灯片的字体和样式,但 Slidev 也提供了一种更省事的配置方式。

在 frontmatter 中按如下方式配置:

---
fonts:
  # 基本正文文字
  sans: Robot
  # 通过 UnoCSS 的 `font-serif` css 类使用
  serif: Robot Slab
  # 用于代码块、行内代码等
  mono: Fira Code
---

就这么简单。字体会通过 CDN 从字体服务商自动导入,默认是 Google Fonts,也就是说你可以直接使用 Google Fonts 上的任意字体。

本地字体

默认情况下,Slidev 假定 fonts 配置里指定的字体都来自 Google Fonts。如果想使用本地字体,可以设置 fonts.local 来关闭自动导入:

---
fonts:
  # 与 css 中的 font-family 一样,可用 `,` 分隔多个字体作为回退
  sans: 'Helvetica Neue,Robot'
  # 将 'Helvetica Neue' 标记为本地字体
  local: Helvetica Neue
---

字重与斜体

默认情况下,Slidev 会为每个字体导入 200、400、600 三种字重,可以按需配置:

---
fonts:
  sans: Robot
  # 默认值
  weights: '200,400,600'
  # 是否导入斜体字体,默认 `false`
  italic: false
---

该配置作用于所有 web 字体。如果需要对每个字体的字重做更细粒度的控制,就需要通过 HTML 和 CSS 手动导入了。

回退字体

大多数情况下,你只需指定"特殊字体",Slidev 会自动为你追加回退字体,例如:

---
fonts:
  sans: Robot
  serif: Robot Slab
  mono: Fira Code
---

会生成如下结果:

.font-sans {
  font-family: "Robot",ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";
}
.font-serif {
  font-family: "Robot Slab",ui-serif,Georgia,Cambria,"Times New Roman",Times,serif;
}
.font-mono {
  font-family: "Fira Code",ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;
}

如果想禁用回退字体,可以这样配置:

---
fonts:
  mono: 'Fira Code, monospace'
  fallbacks: false
---

字体服务商

可选值:google | coollabs | none

默认值:google

目前仅支持 Google Fonts 和 coolLabs,未来计划支持更多服务商。设置为 none 将完全关闭自动导入功能,所有字体都按本地字体处理。

---
fonts:
  provider: none
---

评论 (0)