改变字体

Material for MkDocs 使得更改项目文档的字体变得非常简单，因为它直接集成了Google Fonts。此外，如果出于数据隐私原因或需要使用其他字体资源，还可以自定义加载字体。

配置

普通字体

默认值：Roboto

普通字体用于所有正文、标题和其他不需要等宽字体的内容。可以通过 mkdocs.yml 将其设置为任何有效的Google 字体：

theme:
  font:
    text: Roboto

该字体将以 300、400、400i 和 700 加载。

等宽字体

默认值：Roboto Mono

等宽字体用于代码块，可以单独配置。与普通字体一样，可以通过 mkdocs.yml 将其设置为任何有效的Google 字体：

theme:
  font:
    code: Roboto Mono

该字体将以 400 加载。

自动加载

默认值：无

如果您希望阻止从Google Fonts加载字体（例如遵守数据隐私规定）并回退到系统字体，请将以下行添加到 mkdocs.yml：

theme:
  font: false

自动捆绑 Google Fonts

内置的隐私插件使得在遵守__通用数据保护条例__（GDPR）的同时使用 Google Fonts 变得非常容易，它会自动下载并自托管 Web 字体文件。

自定义

额外字体

如果您想从其他位置加载（额外的）字体或覆盖系统字体，可以使用额外的样式表添加相应的 @font-face 定义：

docs/stylesheets/extra.css

@font-face {
  font-family: "<font>";
  src: "...";
}

mkdocs.yml

extra_css:
  - stylesheets/extra.css

然后，可以将字体应用于特定元素，例如只应用于标题，或者全局应用作为整个站点的普通字体或等宽字体：

普通字体

:root {
  --md-text-font: "<font>"; /* (1)! */
}

1. 始终通过 CSS 变量而不是 font-family 定义字体，因为这样会禁用系统字体的回退。

等宽字体

:root {
  --md-code-font: "<font>";
}