Skip to content

Commit 4ae913c

Browse files
committed
Updated MkDocs 2.0 warning message
1 parent fdf40c0 commit 4ae913c

2 files changed

Lines changed: 26 additions & 14 deletions

File tree

material/plugins/__init__.py

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,19 @@
2626
if not getenv("NO_MKDOCS_2_WARNING"):
2727
print(
2828
"\n"
29-
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
30-
f"{Fore.RED}{Style.RESET_ALL}\n"
31-
f"{Fore.RED}{Style.RESET_ALL} MkDocs 1.x is unmaintained. We recommend switching to Zensical, our\n"
32-
f"{Fore.RED}{Style.RESET_ALL} new static site generator, as soon as possible. We're providing an\n"
33-
f"{Fore.RED}{Style.RESET_ALL} analysis of the situation in this article:\n"
34-
f"{Fore.RED}{Style.RESET_ALL} \n"
35-
f"{Fore.RED}{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
29+
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
30+
f"{Fore.RED}{Style.RESET_ALL}\n"
31+
f"{Fore.RED}{Style.RESET_ALL} MkDocs 2.0 introduces backward-incompatible changes:\n"
32+
f"{Fore.RED}{Style.RESET_ALL}\n"
33+
f"{Fore.RED} │ × {Style.RESET_ALL}All plugins will stop working – the plugin system has been removed\n"
34+
f"{Fore.RED} │ × {Style.RESET_ALL}All theme overrides will break – the theming system has been rewritten\n"
35+
f"{Fore.RED} │ × {Style.RESET_ALL}No migration path exists – existing projects cannot be upgraded\n"
36+
f"{Fore.RED} │ × {Style.RESET_ALL}Closed contribution model – community members can't report bugs\n"
37+
f"{Fore.RED} │ × {Style.RESET_ALL}Currently unlicensed – unsuitable for production use\n"
38+
f"{Fore.RED}{Style.RESET_ALL}\n"
39+
f"{Fore.RED}{Style.RESET_ALL} Our full analysis:\n"
40+
f"{Fore.RED}{Style.RESET_ALL}\n"
41+
f"{Fore.RED}{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
3642
f"{Style.RESET_ALL}",
3743
file=stderr
3844
)

src/plugins/__init__.py

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,19 @@
2626
if not getenv("NO_MKDOCS_2_WARNING"):
2727
print(
2828
"\n"
29-
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
30-
f"{Fore.RED}{Style.RESET_ALL}\n"
31-
f"{Fore.RED}{Style.RESET_ALL} MkDocs 1.x is unmaintained. We recommend switching to Zensical, our\n"
32-
f"{Fore.RED}{Style.RESET_ALL} new static site generator, as soon as possible. We're providing an\n"
33-
f"{Fore.RED}{Style.RESET_ALL} analysis of the situation in this article:\n"
34-
f"{Fore.RED}{Style.RESET_ALL} \n"
35-
f"{Fore.RED}{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
29+
f"{Fore.RED} │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs{Style.RESET_ALL}\n"
30+
f"{Fore.RED}{Style.RESET_ALL}\n"
31+
f"{Fore.RED}{Style.RESET_ALL} MkDocs 2.0 introduces backward-incompatible changes:\n"
32+
f"{Fore.RED}{Style.RESET_ALL}\n"
33+
f"{Fore.RED} │ × {Style.RESET_ALL}All plugins will stop working – the plugin system has been removed\n"
34+
f"{Fore.RED} │ × {Style.RESET_ALL}All theme overrides will break – the theming system has been rewritten\n"
35+
f"{Fore.RED} │ × {Style.RESET_ALL}No migration path exists – existing projects cannot be upgraded\n"
36+
f"{Fore.RED} │ × {Style.RESET_ALL}Closed contribution model – community members can't report bugs\n"
37+
f"{Fore.RED} │ × {Style.RESET_ALL}Currently unlicensed – unsuitable for production use\n"
38+
f"{Fore.RED}{Style.RESET_ALL}\n"
39+
f"{Fore.RED}{Style.RESET_ALL} Our full analysis:\n"
40+
f"{Fore.RED}{Style.RESET_ALL}\n"
41+
f"{Fore.RED}{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
3642
f"{Style.RESET_ALL}",
3743
file=stderr
3844
)

0 commit comments

Comments
 (0)