字体设置¶

MkDocs Material 主题 可以很方便修改项目文档的字体，因为它直接与 Google Fonts 集成。另外，出于数据隐私原因进行私有化离线管理场景，或者需要使用其他来源字体时，也可以自定义加载字体。

配置¶

正文字体、标题以及几乎所有不需要等宽字体的内容都使用常规字体。您可以通过 mkdocs.yml 将其设置为任何有效的 Google 字体.

theme:
  font:
    text: Roboto

默认字体会加载 300, 400, 400i 和 700 几种字重类型。

monospaced字体 用于代码块，可以单独配置。就像常规字体一样，您可以通过 mkdocs.yml 将其设置为任何有效的 Google 字体.

theme:
  font:
    code: Roboto Mono

默认字体会加载 400 字重.

如果你想阻止字体从 Google Fonts 加载，例如：要遵守【数据隐私】规定，并退回到系统字体，请在 mkdocs.yml 添加下面几行

theme:
  font: false

Automatically bundle Google Fonts

built-in privacy plugin 可以在遵守 通用数据保护条例 （GDPR）的情况下，便捷地使用谷歌字体的同时，使用自动下载的和自托管的web字体文件。

如果你想从其他来源加载字体或者覆盖系统字体，你可以使用 additional style sheet 来添加对应的 @font-face 定义：

docs/stylesheets/extra.css mkdocs.yml

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

extra_css:
  - stylesheets/extra.css

字体可以应用于特定的元素，例如，只有标题，或全局性地用作整个网站的常规字体或等宽字体：

常规字体等宽字体

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

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