The Slow Collapse of MkDocs
核心洞察
"MkDocs生态系统正在实时分裂。三个继任者，三种愿景，一个正在决定下注的社区。"
摘要
这是一篇深度长文，讲述了Python最流行的文档工具MkDocs从2014年创建到2026年项目分裂的完整故事。MkDocs为超过90,000个GitHub项目提供文档支持，其中大多数依赖Material for MkDocs主题。
关键事件时间线
- 2014年1月: @lovelydinosaur创建MkDocs，随后在年中完全停止活动
- 2020年4月: @oprypin开始贡献项目
- 2021年5月: @waylan（当时唯一维护者）因与@oprypin的冲突宣布离职
- 2021年7月: @lovelydinosaur邀请@oprypin、@squidfunk、@ultrabug成为维护者
- 2024年3月: @oprypin移除@squidfunk，后被@lovelydinosaur恢复并剥夺@oprypin权限
- 2024年4月: @oprypin宣布辞职
- 2025年11月: Material for MkDocs进入维护模式，Zensical发布
- 2026年1月: @lovelydinosaur宣布MkDocs 2.0（移除插件系统），社区强烈反对
- 2026年3月9日: @oprypin短暂夺取PyPI控制权，后在24小时内放弃
- 2026年3月15日: ProperDocs发布
核心冲突
- 维护者冲突: @oprypin与@squidfunk长期存在个人矛盾，在公开场合互相攻击
- 方向分歧: @lovelydinosaur回归后推动MkDocs 2.0，完全移除插件系统，这正是MkDocs生态系统的核心价值
- 治理问题: 项目创始人长期缺席，社区缺乏透明度和参与机制
分裂的继任者
1. ProperDocs
由@oprypin创建，是MkDocs 1.x的直接替代品，插件系统完全兼容。
2. MaterialX
由@jaywhj创建，Material for MkDocs的社区分支。
3. Zensical
由原Material for MkDocs团队创建，重写版，5倍速度，原生读取mkdocs.yml，目前最受欢迎（3700+ stars）。
教训与思考
- 开源治理的重要性: 项目创始人的长期缺席和突然回归都可能带来灾难性后果
- 社区沟通: 公开争吵和私人矛盾的混合使用户对项目未来失去信心
- 向后兼容性: 2.0版本完全移除插件系统的决定是社区反对的核心原因
- 单一维护者风险: 项目依赖少数核心维护者，一旦他们离开或冲突，项目容易陷入停滞
原文链接
https://fpgmaas.com/blog/collapse-of-mkdocs/
← 返回索引