MkDocs

之前有些笔记是使用 MkDocs + Material Theme 记录的。
最近才发现 MkDocs 已经停止更新、维护一段时间了。
主线最后一个 MkDocs 稳定版本是 1.6.1，发布于 2024-08-30。
最后一个包含新功能的 Material 版本为 9.7.0，发布于 2025-11-11。
Material for MkDocs 进入维护模式，并转向新项目 Zensical。
目前使用 MkDocs 1.6.x + Material 9.7.x 没有问题。

很喜欢 MkDocs + Material 的排版，就是文章一多，比如 50篇 左右会有延迟，超过 100篇 reload 会有些卡，文章再多就很难受了。
MkDocs 是全量更新，Hugo 是增量更新（虽然有时 reload 会导致上一篇、下一篇顺序错乱，但重启也很快），速度确实是 Hugo 快，但听说 Zensical 也很快，可能没有 Hugo 快，但构建速度是 MkDocs 的 4-5 倍。

Zensical

官网

版本

我尝试了一下，python 3.9 是无法使用的。
按官方文档的 python 3.14 没问题。
有网络问题的不要用官网的安装命令 conda install -c conda-forge zensical
直接 pip install zensical
目前版本的依赖如下

Package            Version
------------------ -------
click              8.5.0
deepmerge          3.0.1
Jinja2             3.1.6
Markdown           3.10.3
MarkupSafe         3.0.3
Pygments           2.21.0
pymdown-extensions 11.0.2
PyYAML             6.0.3
tomli              2.4.1
zensical           0.0.59

一些操作

zensical new .  # 新建
zensical serve  # 启动
zensical build  # 打包

配置文件

兼容 mkdocs.yml

zensical.toml
我注释了一项，打开了一项

# "navigation.footer",
"navigation.tabs",