「这是我参与2022首次更文挑战的第24天,活动详情查看:2022首次更文挑战」。

前言

前面我们介绍过 MKDocs 的基础用法(MKDocs 入门)。很多同学都表示非常香,但是默认的主题不够美观,虽然我们可以通过内置的 readthedocs 主题来改善,但是还不够美,今天我们就一起来尝试一款比较现代的 MKDocs 主题 material

关于 material

material 主题是基于 MKDocs 的面向现代化技术python是什么意思文档网站的一个主题,非常的漂亮。

快来美化你的MKDocs吧

呆猫

首先我们 mkdocs init 初始化一个 MKDocs 项目。

快来美化你的MKDocs吧

然后我们 pip install mkdocs-material 下载 material 主题。

最后我们启动项目时指定主题为 materi命令行参数al

快来美化你的MKDocs吧

快来美化你的MKDocs吧

快来美化你的MKDocs吧

怎么样,相比 readthedocsmaterial命令行快捷键效果还是比较清新现代的全栈工程师薪水

material 配置

通常我们会将主题配置到 mkdocs.yaml 中,而非命令行指定。

所以我们需要将主题python代码画樱花markdow命令行查看ip地址n 的高亮配置写到配置文件python下载中。

site_name: My Docs
theme:
  name: material
markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences

配置主题到 mkdocs.yaml 后,启动服务不需要指定主题了。直接 mkdocs serve 即可

代码高亮和标题

material 不但支持代码高亮还支持代码标题。

```python title='demo.py'
def sayhi():
    return "hi,Python全栈开发"
```

快来美化你的MKDocs吧

不但如此,material 还支持代码自由注释,并且交互良好。

```python title='demo.py'
def sayhi():
    return "hi,Python全栈开发" # (1)
```
1. 这是我自由注释的内容,欢迎关注我的公众号。

快来美化你的MKDocs吧

好看的提示框

提示框的配置:

markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences
theme:
  icon:
    admonition:
      note: octicons/tag-16
      abstract: octicons/checklist-16
      info: octicons/info-16
      tip: octicons/squirrel-16
      success: octicons/check-16
      question: octicons/question-16
      warning: octicons/alert-16
      failure: octicons/x-circle-16
      danger: octicons/zap-16
      bug: octicons/bug-16
      example: octicons/beaker-16
      quote: octicons/quote-16

mdmarkdown数学公式 内容:

!!! note "这是 note 类型的提示框"
提示:更多精彩内容记得关注我啊
!!! success "这是 success 类型的提示框"
成功!
!!! failure "这是 failure 类型的提示框"
失败!
!!! bug "这是 bug 类型的提示框"
发现一个 bug,请尽快修复!

快来美化你的MKDocs吧

对于提示框中很多内容的场景,该如何处理呢?material 支持提示框的折叠。

!!! --> ??? 即可。

md 内容:

??? note "这是 note 类型的提示框"
提示:更多精彩内容记得关注我啊
    第二行

    第三行

    第四行

    第五行
    ...

快来美化你的MKDocs吧

更多markdown软件内容:material 官方文档

最后

以上 maMarkdownterial 只展示了部分功能,mat全栈开发是干什么的erial 还支持单词缩写、python可以做什么工作按钮、数据表格、mermaid、锚、字符格式化、EmojiIcon、图片、数学公式等。总之,很强大。

最后,希望我的分享能够对你有所帮助!