Material 主题

Material 主题是 MkDocs 的王牌：内置搜索、导航、标签、代码高亮与丰富组件。

主题特性

内置搜索（基于 lunr.js），可配置多语言。
丰富的 UI 组件：提示块、选项卡、折叠、图标、代码注释。
配色与字体可配置，支持暗色模式。
支持版本下拉（插件）与标签页导航。

配置示例

theme:
  name: material
  language: zh
  features:
    - navigation.tabs
    - search.suggest
    - content.code.copy
  palette:
    - scheme: default
      primary: indigo
      accent: indigo
    - scheme: slate
      primary: indigo
      accent: indigo
  icon:
    logo: material/library

常用扩展

content.code.copy：代码复制按钮。
navigation.tabs：顶栏标签导航。
search.*：搜索建议/高亮。
可与 pymdown-extensions 配合获取更多 Markdown 能力。***

上一章节快速开始安装 MkDocs 和创建项目。下一章节插件生态MkDocs 插件系统和常用插件。