更改字体¶

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

配置¶

常规字体¶

0.1.2 Roboto

常规字体用于所有正文、标题，以及基本上所有不需要等宽的内容。可以通过 mkdocs.yml 设置为任何有效的 Google Font：

theme:
  font:
    text: Roboto

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

等宽字体¶

0.1.2 Roboto Mono

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

theme:
  font:
    code: Roboto Mono

该字体将以 400 的形式加载。

自动加载¶

1.0.0

如果您希望防止从 Google Fonts 加载字体，例如为了遵守 数据隐私 法规，并回退到系统字体，请在 mkdocs.yml 中添加以下行：

theme:
  font: false

自定义¶

额外字体¶

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

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

extra_css:
  - stylesheets/extra.css

然后可以将字体应用于特定元素，例如仅标题，或全局使用作为全站的常规或等宽字体：

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

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