Skip to content

Commit 37683d1

Browse files
committed
Updated blog post on MkDocs 2.0
1 parent 199e315 commit 37683d1

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

docs/blog/posts/mkdocs-2.0.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,18 +16,21 @@ slug: mkdocs-2.0
1616

1717
# What MkDocs 2.0 means for your documentation projects
1818

19-
Last update: March 10, 2026 - see [update log].
19+
Last update: March 10, 2026 see [update log].
2020

2121
---
2222

2323
__Three weeks ago, MkDocs 2.0 was announced – a ground-up rewrite of the documentation tool tens of thousands of projects rely on, introducing potentially significant breaking changes.__
2424

25-
We've taken the time to thoroughly evaluate and test the pre-release version, and we want to share what we know, what it might mean for your documentation projects, and where [Zensical], our new static site generator that is _compatible with MkDocs 1.x_, fits into the picture.
25+
Material for MkDocs depends on MkDocs as its underlying framework and central dependency. We maintain Material for MkDocs, but we have no control over MkDocs itself.
26+
27+
We've taken the time to thoroughly evaluate and test the [MkDocs 2.0 pre-release] and want to share our findings, including what it might mean for your documentation projects, and where [Zensical], our new static site generator that is _compatible with MkDocs 1.x_, fits into the picture.
2628

2729
__If you've missed it__: [MkDocs 1.x is unmaintained], with issues and PRs piling up and no releases in the past 18 months, and seemingly no plans to fix long-standing issues like [live-reload problems]. More importantly, it's unclear whether security issues will be addressed, and whether the project will receive any updates at all in the future.
2830

2931
_Please note that MkDocs 2.0 is still in pre-release, and the information in this article is based on the current state of the project. We keep it updated as we learn more._
3032

33+
[MkDocs 2.0 pre-release]: https://github.com/encode/mkdocs
3134
[Zensical]: zensical.md
3235
[update log]: #updates
3336

@@ -137,6 +140,8 @@ _If you have any questions, feel free to reach out to Kathi at hello@zensical.or
137140

138141
- __February 19, 2026__: The published MkDocs 2.0 roadmap was deleted. The link now points to an issue comment that contains a screenshot of the last available version of the roadmap.
139142

143+
- __February 13, 2026__: The mention of compatibility planned for MkDocs 1.x and MkDocs 2.0 projects was removed from the MkDocs 2.0 [`README.md`](https://github.com/encode/mkdocs/commit/313d3e8#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L52).
144+
140145
[compatibility section]: https://zensical.org/compatibility/features/
141146
[hands-on support for migration]: https://zensical.org/spark/
142147
[website]: https://zensical.org

0 commit comments

Comments
 (0)