欢迎使用 MkDocs Material 主题演示

这是一个使用 MkDocs 和 Material for MkDocs 主题创建的演示站点。

特性

Material for MkDocs 是一个功能强大的文档框架，提供了许多出色的特性：

• 美观的设计 - 现代化的 Material Design 风格
• 深色模式 - 支持亮色/暗色主题切换
• 强大的搜索 - 内置全文搜索功能
• 响应式设计 - 完美支持移动设备
• 丰富的 Markdown 扩展 - 支持各种高级 Markdown 语法

代码示例

Python 代码高亮

def hello_world():
    """一个简单的 Hello World 函数"""
    print("Hello, MkDocs Material!")

if __name__ == "__main__":
    hello_world()

JavaScript 代码

// 异步函数示例
async function fetchData(url) {
    try {
        const response = await fetch(url);
        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
    }
}

提示框

提示

这是一个提示框，用于显示重要信息。

小技巧

Material for MkDocs 支持多种类型的提示框！

警告

请注意这个警告信息。

危险

这是一个危险警告！

表格

功能	描述	状态
搜索	全文搜索功能	✅ 已启用
导航	多级导航菜单	✅ 已启用
代码高亮	语法高亮显示	✅ 已启用
深色模式	主题切换	✅ 已启用

任务列表

• 安装 MkDocs
• 安装 Material 主题
• 配置主题
• 添加示例内容
• 部署到生产环境

Mermaid 图表

graph LR
    A[开始] --> B{是否安装?}
    B -->|是| C[配置主题]
    B -->|否| D[安装 MkDocs]
    D --> C
    C --> E[编写文档]
    E --> F[构建站点]
    F --> G[部署]

快速链接

• 安装指南 - 了解如何安装和配置
• 快速开始 - 快速上手指南
• 用户指南 - 学习如何编写文档

更多信息

访问 MkDocs 官方文档 和 Material for MkDocs 文档 了解更多信息。