MkDocs 主题的中文搜索有点弱
最开始是想着在自己的站点通过 "体积" 的关键词搜索《解决 GitHub 提交次数多导致仓库体积过大的问题》这篇文章，但死活就是搜不到。 换成 "次数"、"次数多" 这个关键词还是搜不到。 后来换成 "提交"、"提交次数" 反倒是搜索出来了。 同样的问题在 Material for MkDocs 官方站点 同样也是不如人意。 从现有的一些资料可以看到这其实是中文分词，文本没有被正确分割导致…
Steven Shum
A Bioinformatics Engineer.
mkdocs 6
185 184 MkDocs 的缓慢崩溃
从 2023 年 7 月开始，个人的 博客站点 从 Hugo 换成了 Material for MkDocs 并在 2026 年换成了 MaterialX，但始终都没有脱离过 MkDocs 的框架。 作为使用者，和 MkDocs 生态关注者，现如今 MkDocs 生态系统分崩离析，给大家分享一篇来自 Florian Maas 在 2026 年 3 月 22 写的《The Slow Collapse…
1 comment110 MkDocs Material 大法好
Categories: 博客/好玩 自从用上了 MkDocs Material，除了可以用作专业的文档生成器，发现其实也可以干些其他的杂活，例如用它自定义一个更加有辨识度的 Homepage，用它搭建一个属于自己的导航站点。 Hugo 的 Navpage 导航虽然颜值上更舒服一些，但是和博客、站内搜索的集成依然有些割裂，自己对 Hugo 越来越缺乏学习的热情。另外一方面，反而更加热衷于在 GitH…
1 comment65 RSS 订阅插件 mkdocs-rss-plugin 的一些问题
聊一下 Mkdocs Material 的默认插件 mkdocs-rss-plugin 在使用上的一些问题。 对于 blog 插件，默认的 RSS 里边提供的地址有一部分会默认为目录链接(例如 category 和 archive)，而非文章地址。 针对这一种情况，需要使用 RSS 配置的 match_path，即可解决：
2 comments51 MkDocs 的 Nav 导航结构与目录自定义调整插件使用
很长一段时间都在使用 mkdocs_include_dir_to_nav 这个插件来自动包含目录下的所有 md 文件，但随着新需求的出现 —— 如何给某一个指定的子目录使用 reverse_sort_file，即升序排列展示子目录相应的 markdown 内容。这才开始接触到 MkDocs Awesome Pages Plugin 这个插件。 值得注意的是，MkDocs Awesome Pages…
14 基于 Mkdocs 的主题与站点
鉴于 MkDocs 的诸多优点，让它被很多知名开源项目选中，用于搭建和项目相关的文档网站。比如 Python 里知名的 Web 圈里的 django-rest-framework、FastAPI 以及基于 Go 编写的云网关代理服务器 traefik 等项目的官方文档站点，都是通过 MkDocs 进行搭建。 下面列的是搜集的一些 Mkdocs 主题与站点，以供参考。 Hello 算法 - FDU-…