跳转至

高级功能

自定义 CSS

在 docs/stylesheets/extra.css 中创建自定义样式：

:root {
  --md-primary-fg-color: #00897b;
}

.md-typeset h1 {
  color: var(--md-primary-fg-color);
}

在 mkdocs.yml 中引用：

extra_css:
  - stylesheets/extra.css

自定义 JavaScript

在 docs/javascripts/extra.js 中添加自定义脚本：

document.addEventListener("DOMContentLoaded", function() {
  console.log("文档已加载");
});

在 mkdocs.yml 中引用：

extra_javascript:
  - javascripts/extra.js

添加图标

Material 主题支持 Material Icons 和 FontAwesome 图标：

<span class="twemoji">
  {% include '.icons/fontawesome/solid/home.svg' %}
</span>

搜索优化

plugins:
  - search:
      lang:
        - zh
        - en
      separator: '[\s\-\.]+'

版本控制

extra:
  version:
    provider: mike

社交链接

extra:
  social:
    - type: github
      link: https://github.com/yourusername
    - type: twitter
      link: https://twitter.com/yourusername

版权信息

copyright: Copyright &copy; 2024 Your Name

提示

Material 主题提供了更多高级功能，如博客支持、评论系统、分析工具等。查看 官方文档 了解详情。