我的 MkDocs 笔记本

“你的网站是怎么做的？”

虽然本站做的非常粗糙和简陋，但笔者自认为内容和结构也比较清晰 （大佬们请轻喷），并且从 2023 年暑假着手创建本站，到如今（2025 年春节）上线这个比较完整的版本，中间遇到了很多的问题，故在此笔者将自己制作本站的过程记录下来作为一个“教程”，以供有需要的伙伴参考。

提示

与网上其他大部分教程不同的是，本文不会花非常大的篇幅来描述 MkDocs 站点的详细配置，而是从“零”基础的角度出发，侧重于一个“小白”在搭建 MkDocs 站点时可能会遇到的问题和解决方法。

由于本站并不是所有人眼中的最佳形态（包括笔者自己），所以请各位有更好的建议请不吝赐教，笔者将不胜感激。