mkdocs-ng v1.8.0 is out, the first feature release since the fork. Built-in themes no longer copy the entire highlight.js distribution, making clean builds ~14% faster with ~440 fewer files per site. Search finally finds programming keywords like while and if. The next release will bring incremental builds to mkdocs serve.
Since taking over mkdocs-ng maintenance, four versions have been released, over a dozen bugs fixed, and the mergedeep dependency removed. The upcoming v1.8.0 will be a feature release, planning to drop support for older Python versions, remove CDN dependencies from built-in themes, and provide a stable Python API.
MkDocs has not shipped a release since August 2024, and Material for MkDocs went into maintenance mode in November 2025. I rely on both across my own projects, so I forked them as mkdocs-ng and mkdocs-ng-material. The CLI, mkdocs.yml and plugins stay the same; only the package names change.
In enterprises, documentation tools like Wiki and Confluence, if lacking unified management and review mechanisms, can lead to information chaos and knowledge sedimentation failure. This article explores how to avoid this situation and draws on the successful experiences of open-source communities.
In open-source projects or team collaborations, Sphinx + ReadTheDocs provides an easy-to-maintain, automatically deployable documentation system. This article documents the configuration process and considerations.
Markdown and reStructuredText (RST) are two commonly used markup languages. This article compares their advantages and disadvantages and shares usage suggestions in different scenarios.
