更改字体¶

Material for MkDocs 可以轻松更改项目文档的字体，因为它直接与 Google Fonts 集成。或者，如果出于数据隐私原因首选自托管或应使用其他目标，则可以自定义加载字体。

配置¶

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

theme:
  font:
    text: Roboto

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

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

theme:
  font:
    code: Roboto Mono

字体将以 400 加载。

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

theme:
  font: false

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

docs/stylesheets/extra.css mkdocs.yml

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

extra_css:
  - stylesheets/extra.css

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

Regular fontMonospaced font

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

Always define fonts through CSS variables and not font-family, as this would disable the system font fallback.

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