mkdocs-material 入门开启

经常性的有书写技术文档和教程的需要

个人不太喜欢 把数据托管到第三方平台，包括在博客园的投稿 基本也是为了备份

mkdocs-material 使用Python 开发的文档书写工具，完美满足需求，界面美观 适应多设备

安装

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple mkdocs mkdocs-material

运行

mkdocs serve

创建项目

mkdocs new test

设定主题

theme:
  name: material

底部以及一键回顶部

    features:
    - navigation.footer
    - content.code.copy
    - navigation.top # 一键回顶部

相关资源

• https://squidfunk.github.io/mkdocs-material/
• https://shafish.cn/blog/mkdocs/#3-logofavicon