Material for MkDocs Insiders – 现在对所有人免费¶

9.7.0，Material for MkDocs 的最终版本，包含了之前仅限赞助者的所有功能，使得 Material for MkDocs Insiders 对所有人开放！

随着我们将精力转向 Zensical，Material for MkDocs 正在进入维护模式。这意味着虽然我们将在至少 12 个月内继续修复关键错误和安全问题，但不会再向 Material for MkDocs 添加新功能。

我们还将停止赞助软件模型，向 [GitHub Sponsors] 说再见。如果您曾是我们工作的赞助者，您已经收到了一封提到您的赞助已被取消的电子邮件。作为过去几年中赞助 Material for MkDocs 的众多个人和组织之一——谢谢您！您持续的支持是无价的。

现在，我们希望每个人都能受益于我们为 Material for MkDocs 开发的所有功能，这就是我们将所有 Insiders 功能对所有人开放的原因！

这是我们在专注于 Zensical 之旅中的逻辑下一步——Zensical 是我们从零开始构建的下一代静态网站生成器，旨在克服 MkDocs 的技术限制。Zensical 完全开源，采用 MIT 许可证，保持与 [Material for MkDocs] 的 [兼容性]，并且可以在最小更改的情况下构建您现有的项目。

在接下来的几个月里，我们将缩小功能平价差距，将 Material for MkDocs 的表现力带入 Zensical。

您可以订阅我们的新闻通讯以保持最新信息。

这是四部分系列中的第三篇文章：

可用功能¶

我们的赞助者已经享受了以下高级功能的独占访问权相当长一段时间。随着 9.7.0 的发布，所有这些功能现在对所有人开放：

mkdocstrings Insiders 现在也免费

随着 Timothée 加入 Zensical 团队，他宣布所有之前作为 mkdocstrings Insiders 的赞助者保留的功能现在也对所有人免费！

如何升级¶

您可以使用以下命令进行升级：

pip install --upgrade --force-reinstall mkdocs-material

从 Insiders 切换¶

如果您一直是 Insiders 的用户，我们建议尽快切换到社区版，因为它包含所有 Insiders 功能。这将使处理第三方贡献变得更加容易，因为不再需要个人访问令牌。

从现在开始，我们对 Material for MkDocs 的错误修复将仅发布到社区版。安全漏洞将在两个版本中修复。

因此，请调整您的 requirements.txt 和 GitHub Actions 工作流：

- pip install git+https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git
+ pip install mkdocs-material

Insiders 仓库本身将在接下来的 6 个月内保持可用。当您使用 Insiders 构建项目时，它将显示一条信息，指向这篇博客文章。

在 2026 年 2 月 1 日，这条信息将变成警告。
在 2026 年 5 月 1 日，Insiders 仓库将被删除。

日落准备¶

进入维护模式，我们正在为 Material for MkDocs 准备日落。

Material for MkDocs 现在处于维护模式

我们希望对继续使用 Material for MkDocs 的风险保持透明。由于 MkDocs 不再维护并面临基本的供应链问题，我们无法保证 Material for MkDocs 将在未来继续可靠地工作。我们意识到过渡需要时间，这就是为什么我们承诺至少在接下来的 12 个月内支持它，根据需要修复关键错误和安全漏洞，但前进的道路是 Zensical。

如果文档在您的组织中扮演着关键角色，并且您担心这可能会影响您的业务，请考虑加入 Zensical Spark，或者随时通过 contact@zensical.org 安排电话会议。

弃用¶

虽然我们将所有功能发布给公众，但与此同时，由于可维护性问题，我们正在弃用项目插件和排版插件。这意味着这些插件将不再收到任何更新，包括不再修复错误。

做出这一决定的原因是这两个插件依赖于太多的变通方法来使其与 MkDocs 一起工作，因此成为创建 Zensical 的关键动机。如果您依赖这些插件，并且它们适用于您的用例，您当然可以继续使用它们。

通过 Zensical，我们将提供适当的子项目支持，包括国际化和版本控制，并与我们的专业用户在 Zensical Spark 中共同设计这些功能。

版本范围¶

Material for MkDocs 一直使用语义版本范围来确保兼容性。随着 9.7.0 的到来，我们将从语义版本切换到最小版本范围。这为依赖项解析提供了更多灵活性，特别是允许用户使用包含重要错误修复或安全补丁的更新版本的依赖项。

安全¶

我们不会将 Material for MkDocs 仓库的所有权转让给其他个人或组织。该仓库和 PyPI 包将保持在 @squidfunk 的所有权之下，从而保持用户所依赖的可信供应链。

因此，如果您希望承担 Material for MkDocs 的维护工作，请创建一个分支。

展望未来¶

实现可持续性¶

在 Material for MkDocs 依赖于赞助软件的地方，Zensical 采取了一种新方法，以确保它能够不断发展以满足构建复杂企业级文档的组织的需求。

Zensical Spark 是一个协作空间，专业用户在塑造 Zensical 的未来方面拥有直接发言权。通过结构化设计过程，以及与我们的 Zensical Spark 成员共同合作，我们识别机会，验证提案并定义优先级——将他们在现实世界中的文档挑战转化为惠及整个社区的功能。

请通过 contact@zensical.org 联系我们，安排电话会议以了解更多关于 Zensical Spark 的信息，讨论您组织的需求，以及它如何帮助我们使 Zensical 可持续。

我们对您的承诺¶

如果您当前正在使用 Material for MkDocs，则无需急于切换。我们承诺在接下来的 12 个月内保持其安全和功能，同时将精力集中在 Zensical 上。

9.7.0 的发布标志着一个重要的转变——每个 Insiders 功能现在对所有人开放，无需赞助。随着我们构建 Zensical，这些功能将被重新架构和改进。Zensical 完全免费且开源，确保整个社区都能无障碍地受益于我们的工作。

当您准备好探索下一步时，Zensical 与 Material for MkDocs 兼容，并旨在成为您已经熟悉的理念和原则的自然演变。

如果您喜欢 Material for MkDocs 并对 Zensical 感到兴奋，我们将在接下来的几个月中提供支持我们工作的新的方法，并有可能获得独家好处。

请订阅我们的新闻通讯以保持最新信息。