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