更改字体¶

MkDocs的材料使更改项目的字体变得容易 文档，因为它直接与[谷歌字体]集成。或者， 如果出于数据隐私原因首选自托管，则可以自定义加载字体 或者应该使用另一个目的地。

配置¶

常规字体¶

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

theme:
  font:
    text: Roboto

字体将加载为300、400、400i_和700__。

等宽字体¶

_monospace font_用于代码块，可以单独配置。 就像常规字体一样，它可以设置为任何有效的[谷歌字体] [谷歌字体]通过mkdocs.yml：

theme:
  font:
    code: Roboto Mono

字体将加载400。

自动加载¶

如果你想阻止从[谷歌字体]加载字体，例如。 要遵守[数据隐私]规定，并退回到系统字体，请添加 将以下行转换为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>";
}