From 529a05f363bc9c6e5edc4d007d49a3a0b578639f Mon Sep 17 00:00:00 2001
From: Xianpeng Shen
Date: Sat, 14 Nov 2026 19:49:15 +0000
Subject: [PATCH 1/2] Add an "Is MkDocs still maintained?" page and retitle the
comparison
People who wonder whether MkDocs is dead, or what to use instead, search for
exactly that. Answer it on one page: the state of MkDocs 1.x and 2.0, whether
a site stops building, Material's end of life, the alternatives and what
MkDocs NG promises, each with dated, sourced facts.
Retitle the comparison page "MkDocs Alternatives Compared" (nav: "MkDocs
Alternatives"), update its latest-release row, and link both pages from the
home page.
---
docs/about/comparison.md | 24 ++--
docs/index.md | 4 +-
docs/user-guide/README.md | 5 +
docs/user-guide/is-mkdocs-still-maintained.md | 114 ++++++++++++++++++
docs/user-guide/material-end-of-life.md | 6 +-
mkdocs.yml | 4 +-
6 files changed, 144 insertions(+), 13 deletions(-)
create mode 100644 docs/user-guide/is-mkdocs-still-maintained.md
diff --git a/docs/about/comparison.md b/docs/about/comparison.md
index 69c7902b..cc2dab4f 100644
--- a/docs/about/comparison.md
+++ b/docs/about/comparison.md
@@ -1,16 +1,22 @@
-# MkDocs NG and Its Alternatives
+---
+description: "MkDocs NG, ProperDocs, Zensical, MkDocs 1.6 and MkDocs 2.0 compared: which ones run your plugins and themes, how fast they build, and which one to use."
+---
+
+# MkDocs Alternatives Compared
-How MkDocs NG relates to the other tools that build MkDocs sites.
+MkDocs NG, ProperDocs, Zensical and upstream MkDocs, side by side.
---
-Since upstream MkDocs 1.x stopped being developed, several projects have
-offered a way forward for existing MkDocs sites. This page compares them on
-what matters when you already have a site: whether it keeps building
-unchanged, and whether your plugins keep running.
+Since upstream MkDocs 1.x stopped being developed (see
+[Is MkDocs Still Maintained?](../user-guide/is-mkdocs-still-maintained.md)),
+several projects have offered a way forward for existing MkDocs sites. This
+page compares them on what matters when you already have a site: whether it
+keeps building unchanged, and whether your plugins keep running.
-Facts on this page were checked on 2026-11-01 against each project's PyPI
-release history, documentation and source code; see [Sources](#sources).
+Facts on this page were checked on 2026-11-01, and release versions on
+2026-11-14, against each project's PyPI release history, documentation and
+source code; see [Sources](#sources).
Build times were measured on 2026-11-04.
Projects change quickly, so check their documentation for the current state.
If something here is wrong or out of date, please
@@ -21,7 +27,7 @@ If something here is wrong or out of date, please
| MkDocs NG | MkDocs 1.6 | MkDocs 2.0 pre-releases | ProperDocs | Zensical
--- | --- | --- | --- | --- | ---
What it is | Maintained fork of MkDocs 1.x | Last upstream 1.x release | Upstream rewrite | Fork of MkDocs 1.6 | New generator by the Material for MkDocs team
-Latest release | 1.11.0 (2026-11-04) | 1.6.1 (2024-08-30) | 2.0.dev6 (2026-09-15) | 1.6.7 (2026-03-20) | 0.0.74 (2026-10-30)
+Latest release | 1.11.2 (2026-11-11) | 1.6.1 (2024-08-30) | 2.0.dev6 (2026-09-15) | 1.6.7 (2026-03-20) | 0.1.1 (2026-11-10)
PyPI package | `mkdocs-ng` | `mkdocs` | `mkdocs` (`--pre`) | `properdocs` | `zensical`
Command | `mkdocs` | `mkdocs` | `mkdocs` | `properdocs` | `zensical`
Configuration | `mkdocs.yml` | `mkdocs.yml` | None; refuses to run when `mkdocs.yml` exists | `properdocs.yml`, falls back to `mkdocs.yml` | `mkdocs.yml` or `zensical.toml`
diff --git a/docs/index.md b/docs/index.md
index 205fd0c7..4d40e250 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,7 +1,7 @@
---
template: landing.html
title: MkDocs NG
-description: Write Markdown. Ship docs. The maintained MkDocs that keeps your plugins working.
+description: "Write Markdown. Ship docs. MkDocs NG is the maintained fork of MkDocs 1.x: same mkdocs command, same mkdocs.yml, and your plugins and themes keep working."
hero:
eyebrow: "MkDocs NG"
title: "Write Markdown.
*Ship docs.*"
@@ -77,7 +77,7 @@ sections:
reverse: true
eyebrow: Already on MkDocs?
title: Switching is a package change.
- text: "MkDocs NG keeps the `mkdocs` command, imports and configuration. Your plugins and themes keep working, and bugs that stayed open upstream are fixed. See [how it compares](about/comparison/) to the alternatives."
+ text: "MkDocs NG keeps the `mkdocs` command, imports and configuration. Your plugins and themes keep working, and bugs that stayed open upstream are fixed. Wondering [whether MkDocs is still maintained](user-guide/is-mkdocs-still-maintained/)? See [how MkDocs NG compares](about/comparison/) to the alternatives."
actions:
- {text: Switching to MkDocs NG, link: user-guide/migrating/, primary: true}
- {text: Fixed upstream issues, link: about/fixed-upstream-issues/}
diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md
index c2250492..be12f998 100644
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
@@ -1,3 +1,7 @@
+---
+description: "The MkDocs NG user guide: installing, writing, theming, configuring and deploying your documentation."
+---
+
# User Guide
Building Documentation with MkDocs
@@ -10,6 +14,7 @@ page listed below, or use the *next* and *previous* buttons in the navigation
bar at the top of the page to move through the documentation in order.
- [Installation](installation.md)
+- [Is MkDocs Still Maintained?](is-mkdocs-still-maintained.md)
- [Switching to MkDocs NG](migrating.md)
- [Material for MkDocs End of Life](material-end-of-life.md)
- [Writing Your Docs](writing-your-docs.md)
diff --git a/docs/user-guide/is-mkdocs-still-maintained.md b/docs/user-guide/is-mkdocs-still-maintained.md
new file mode 100644
index 00000000..8c3c6c57
--- /dev/null
+++ b/docs/user-guide/is-mkdocs-still-maintained.md
@@ -0,0 +1,114 @@
+---
+description: "Upstream MkDocs 1.x has had no release since August 2024, and MkDocs 2.0 is an incompatible rewrite. What that means for your site, and the maintained ways to keep it building."
+---
+
+# Is MkDocs Still Maintained?
+
+The state of MkDocs today, and what it means for your site.
+
+---
+
+Short answer: **upstream MkDocs 1.x is no longer developed.** Its last release
+is 1.6.1, from 2024-08-30. Upstream work moved to MkDocs 2.0, a rewrite that
+can't build existing sites. Your site keeps building on 1.6.1 for now, and
+[MkDocs NG](#what-is-mkdocs-ng) continues 1.x with the same `mkdocs` command,
+`mkdocs.yml`, plugins and themes.
+
+Facts on this page were checked on 2026-11-14 against the PyPI release history
+and documentation of each project; see [Sources](#sources). If something here
+is wrong or out of date, please [open an issue].
+
+## What is the state of MkDocs 1.x?
+
+There has been no release of MkDocs 1.x since 1.6.1 on 2024-08-30.
+`pip install mkdocs` still installs it, and sites, plugins and themes built
+for it keep working. Bugs reported since then stay unfixed, and 1.6.1 declares
+support for Python 3.8 to 3.12 only. Many of the bugs that stayed open
+upstream are listed, with their fixes, in
+[Fixed Upstream Issues](../about/fixed-upstream-issues.md).
+
+## What is MkDocs 2.0?
+
+MkDocs 2.0 is a rewrite, published as pre-releases of the `mkdocs` package
+since 2026-08-28; the latest is 2.0.dev6, from 2026-09-15. It has no
+configuration file, plugins or themes: it builds a folder of Markdown files
+with one Jinja template, and stops with an error when it finds a
+`mkdocs.yml`. Existing sites can't be built with it.
+
+Because these are pre-releases, `pip install mkdocs` doesn't install them.
+`pip install --pre mkdocs` and `uv --prerelease allow` do, so avoid those in
+the environment you build your site in.
+
+## Will my site stop building?
+
+Not today. With `mkdocs` pinned below 2.0, for example `mkdocs<2`, your site
+keeps building as it does now. What it doesn't get on 1.6.1 is fixes: for
+bugs, for new Python versions, and for new versions of Python-Markdown, Jinja
+and the other libraries it uses. The longer a site stays on 1.6.1, the more
+likely one of those breaks it.
+
+## Is Material for MkDocs still maintained?
+
+Material for MkDocs is in maintenance mode, with critical fixes and security
+updates until its end of life on 2027-05-05. Its team now develops Zensical.
+[Material for MkDocs End of Life](material-end-of-life.md) lists your options,
+including MkDocs NG Material, which keeps the `material` theme maintained
+after that date.
+
+## What are the alternatives to MkDocs?
+
+For an existing MkDocs site, these are the ways forward:
+
+Project | What it is | Runs MkDocs plugins | Latest release
+--- | --- | --- | ---
+[MkDocs NG](#what-is-mkdocs-ng) | Maintained fork of MkDocs 1.x, same `mkdocs` command | Yes | 1.11.2 (2026-11-11)
+[ProperDocs] | Fork of MkDocs 1.6, with its own `properdocs` command | Yes | 1.6.7 (2026-03-20)
+[Zensical] | New generator from the team behind Material for MkDocs | No; reimplements about 30 popular plugins | 0.1.1 (2026-11-10)
+MkDocs 1.6.1 | The last upstream 1.x release | Yes | 1.6.1 (2024-08-30)
+
+[MkDocs Alternatives Compared](../about/comparison.md) compares them in detail,
+with build times, and says which one suits which site.
+
+## What is MkDocs NG?
+
+MkDocs NG is a maintained fork of MkDocs 1.x, published on PyPI as
+`mkdocs-ng`. It keeps the `mkdocs` command, `mkdocs.yml`, `import mkdocs` and
+the plugin and theme APIs, so switching is a package change:
+
+```bash
+pip install mkdocs-ng
+```
+
+* **Your plugins keep working.** Every change is tested by building sites
+ with around 30 popular plugins, themes and Markdown extensions.
+* **Regular releases.** Nine releases since April 2026, the latest on
+ 2026-11-11; see the [release notes](../about/release-notes.md).
+* **A dated support promise.** MkDocs NG 1.x gets bug, security and
+ compatibility fixes until at least 2028-12-31; see
+ [Versioning and support](../about/release-notes.md#versioning-and-support).
+* **Current Python.** It supports Python 3.10 to 3.15.
+* **Open governance.** Who maintains it, how decisions are made and what
+ happens if a maintainer steps away is written down in
+ [Governance](../about/governance.md).
+
+To try it on your site before you change anything, see
+[Switching to MkDocs NG](migrating.md#try-it-first). Switching back is the
+same one-line change.
+
+## Sources
+
+* PyPI release history:
+ [mkdocs](https://pypi.org/project/mkdocs/#history),
+ [mkdocs-ng](https://pypi.org/project/mkdocs-ng/#history),
+ [properdocs](https://pypi.org/project/properdocs/#history),
+ [zensical](https://pypi.org/project/zensical/#history).
+* MkDocs 2.0: the [package description](https://pypi.org/project/mkdocs/2.0.dev6/)
+ and the source code of 2.0.dev6.
+* Material for MkDocs maintenance:
+ [upcoming changes](https://zensical.org/upcoming-changes/#material-for-mkdocs).
+* Zensical:
+ [MkDocs plugin support](https://zensical.org/docs/compatibility/mkdocs/plugins/).
+
+[open an issue]: https://github.com/mkdocs-ng/mkdocs/issues
+[ProperDocs]: https://properdocs.org/
+[Zensical]: https://zensical.org/
diff --git a/docs/user-guide/material-end-of-life.md b/docs/user-guide/material-end-of-life.md
index 1c226467..151d40bd 100644
--- a/docs/user-guide/material-end-of-life.md
+++ b/docs/user-guide/material-end-of-life.md
@@ -1,3 +1,7 @@
+---
+description: "Material for MkDocs reaches end of life on 2027-05-05. Your options: MkDocs NG Material, Zensical, MaterialX or Sumi, and who each one suits."
+---
+
# Material for MkDocs End of Life
Your options when Material for MkDocs stops being maintained.
@@ -127,7 +131,7 @@ Your site needs no changes.
dependencies).
* MkDocs NG Material: [documentation][ng-material] and
[PyPI page][ng-material-pypi].
-* [MkDocs NG and its alternatives](../about/comparison.md) compares the
+* [MkDocs Alternatives Compared](../about/comparison.md) compares the
build tools.
[open an issue]: https://github.com/mkdocs-ng/mkdocs/issues
diff --git a/mkdocs.yml b/mkdocs.yml
index 81042683..7ad0e9f9 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -11,6 +11,8 @@ theme:
logo: img/logo.svg
logo_dark: img/logo-dark.svg
favicon: img/favicon.svg
+ # Shown when a page is shared on social media.
+ social_image: img/social.png
# Brand blue; docs/css/extra.css sets a lighter blue for the dark palette.
accent: "#0061fe"
@@ -22,7 +24,7 @@ nav:
- About:
- Release Notes: about/release-notes.md
- Fixed Upstream Issues: about/fixed-upstream-issues.md
- - Comparison: about/comparison.md
+ - MkDocs Alternatives: about/comparison.md
- Contributing: about/contributing.md
- Governance: about/governance.md
- License: about/license.md
From 82ee801e9ad740cdee5fe792220f0fde8c49d8bd Mon Sep 17 00:00:00 2001
From: Xianpeng Shen
Date: Sat, 14 Nov 2026 19:49:15 +0000
Subject: [PATCH 2/2] Give every docs page a description, a social image and a
robots.txt
Every page had the same meta description (site_description), so search results
and llms.txt showed one generic line for all of them. Each page now has its own
description in front matter, which Sumi uses for the meta, Open Graph and
Twitter tags and llms_txt for its page list.
Also:
* docs/robots.txt points crawlers at the sitemap (robots.txt was a 404).
* theme.social_image: link previews get the MkDocs NG card instead of none.
* The Markdown copies of Governance and Contributing held only a snippet line;
docs/hooks.py now inlines included .md files so llms.txt has their text.
* README leads with what MkDocs NG is and why it exists, links the new page,
and links the catalog, Sumi and NG Material sites instead of their repos.
* pyproject.toml gets keywords for PyPI search.
---
README.md | 24 ++++++++++++++--------
docs/about/contributing.md | 4 ++++
docs/about/fixed-upstream-issues.md | 4 ++++
docs/about/governance.md | 4 ++++
docs/about/license.md | 4 ++++
docs/about/release-notes.md | 4 ++++
docs/dev-guide/README.md | 4 ++++
docs/dev-guide/api.md | 4 ++++
docs/dev-guide/plugins.md | 4 ++++
docs/dev-guide/themes.md | 4 ++++
docs/dev-guide/translations.md | 4 ++++
docs/getting-started.md | 4 ++++
docs/hooks.py | 14 +++++++++++++
docs/img/social.png | Bin 0 -> 75869 bytes
docs/robots.txt | 4 ++++
docs/user-guide/choosing-your-theme.md | 4 ++++
docs/user-guide/cli.md | 4 ++++
docs/user-guide/configuration.md | 4 ++++
docs/user-guide/customizing-your-theme.md | 4 ++++
docs/user-guide/deploying-your-docs.md | 4 ++++
docs/user-guide/installation.md | 4 ++++
docs/user-guide/localizing-your-theme.md | 4 ++++
docs/user-guide/migrating.md | 4 ++++
docs/user-guide/multi-language-sites.md | 4 ++++
docs/user-guide/python-api.md | 4 ++++
docs/user-guide/versioned-docs.md | 4 ++++
docs/user-guide/writing-your-docs.md | 4 ++++
mkdocs/tests/docs_hooks_tests.py | 10 +++++++++
pyproject.toml | 9 ++++++++
29 files changed, 145 insertions(+), 8 deletions(-)
create mode 100644 docs/img/social.png
create mode 100644 docs/robots.txt
diff --git a/README.md b/README.md
index 94a47e0b..e2050b70 100644
--- a/README.md
+++ b/README.md
@@ -30,9 +30,16 @@
Documentation ·
Switching from MkDocs ·
Release notes ·
- Plugin catalog
+ Plugin catalog
+**MkDocs NG** is the maintained fork of [MkDocs][mkdocs/mkdocs] 1.x. Upstream
+MkDocs has had no 1.x release since August 2024, and its 2.0 rewrite can't
+build existing sites. MkDocs NG keeps the `mkdocs` command, `mkdocs.yml`,
+plugins and themes working, with bug, security and compatibility fixes until at
+least 2028-12-31. See [Is MkDocs still maintained?][is-maintained] and
+[MkDocs alternatives compared][comparison].
+
MkDocs is a **fast**, **simple**, and **downright gorgeous** static site
generator that's geared towards building project documentation. Documentation
source files are written in Markdown and configured with a single YAML
@@ -55,9 +62,8 @@ third-party themes, plugins, and Markdown extensions.
> [!NOTE]
-> **MkDocs NG** is a maintained fork of [mkdocs/mkdocs], published on PyPI as
-> `mkdocs-ng` while keeping the `mkdocs` command, imports and configuration
-> unchanged — a drop-in replacement.
+> **MkDocs NG** is published on PyPI as `mkdocs-ng` while keeping the `mkdocs`
+> command, imports and configuration unchanged — a drop-in replacement.
>
> Highlights beyond the last upstream release: Python 3.10–3.15 support,
> built-in `llms.txt` and per-page Markdown output for LLMs and coding agents,
@@ -118,7 +124,8 @@ first, but they are still welcome in [Discussions].
- [Fixed Upstream Issues][fixed-upstream]
- [Switching to MkDocs NG][migrating]
- [Governance and how long 1.x is supported][governance]
-- [Comparison with upstream MkDocs 2.0, ProperDocs and Zensical][comparison]
+- [Is MkDocs still maintained?][is-maintained]
+- [MkDocs alternatives compared: MkDocs NG, MkDocs 2.0, ProperDocs and Zensical][comparison]
- [Catalog of third-party plugins, themes and recipes][catalog]
- [Sumi][sumi], a local-first documentation theme from the MkDocs NG project
- [MkDocs NG Material][ng-material], Material for MkDocs maintained for MkDocs NG
@@ -145,12 +152,13 @@ discussion forums are expected to follow the [PyPA Code of Conduct].
[plugins-install]: https://mkdocs-ng.org/user-guide/installation/#plugins-themes-and-the-mkdocs-package
[migrating]: https://mkdocs-ng.org/user-guide/migrating/
[comparison]: https://mkdocs-ng.org/about/comparison/
+[is-maintained]: https://mkdocs-ng.org/user-guide/is-mkdocs-still-maintained/
[governance]: https://mkdocs-ng.org/about/governance/
[Contributing Guide]: https://mkdocs-ng.org/about/contributing/
[PyPA Code of Conduct]: https://www.pypa.io/en/latest/code-of-conduct/
-[catalog]: https://github.com/mkdocs-ng/catalog
-[sumi]: https://github.com/mkdocs-ng/mkdocs-sumi
-[ng-material]: https://github.com/mkdocs-ng/mkdocs-material
+[catalog]: https://catalog.mkdocs-ng.org/
+[sumi]: https://sumi.mkdocs-ng.org/
+[ng-material]: https://material.mkdocs-ng.org/
## License
diff --git a/docs/about/contributing.md b/docs/about/contributing.md
index 0c7bc9cb..2d9dd81d 100644
--- a/docs/about/contributing.md
+++ b/docs/about/contributing.md
@@ -1 +1,5 @@
+---
+description: "How to report bugs, propose changes and send pull requests to MkDocs NG, the maintained fork of MkDocs 1.x."
+---
+
--8<-- ".github/CONTRIBUTING.md"
diff --git a/docs/about/fixed-upstream-issues.md b/docs/about/fixed-upstream-issues.md
index fe5ec114..e8d39e96 100644
--- a/docs/about/fixed-upstream-issues.md
+++ b/docs/about/fixed-upstream-issues.md
@@ -1,3 +1,7 @@
+---
+description: "Long-standing upstream MkDocs bugs that are fixed in MkDocs NG, with the release that fixed each one. Upgrading is a one-line change."
+---
+
# Upstream Issues Fixed in MkDocs NG
MkDocs NG is a maintained fork of [mkdocs/mkdocs], which is no longer under
diff --git a/docs/about/governance.md b/docs/about/governance.md
index 246f1ae1..c09827c0 100644
--- a/docs/about/governance.md
+++ b/docs/about/governance.md
@@ -1 +1,5 @@
+---
+description: "Who maintains MkDocs NG, how decisions are made, how releases are published and what happens if a maintainer steps away."
+---
+
--8<-- ".github/GOVERNANCE.md"
diff --git a/docs/about/license.md b/docs/about/license.md
index 44546d3c..4cd88d1a 100644
--- a/docs/about/license.md
+++ b/docs/about/license.md
@@ -1,3 +1,7 @@
+---
+description: "MkDocs NG is open source under the BSD 2-Clause license. Licenses of the projects it includes."
+---
+
# License
The legal stuff.
diff --git a/docs/about/release-notes.md b/docs/about/release-notes.md
index 5fae93ba..36c1bbb1 100644
--- a/docs/about/release-notes.md
+++ b/docs/about/release-notes.md
@@ -1,3 +1,7 @@
+---
+description: "Release notes for every MkDocs NG version, and the versioning and support rules: MkDocs NG 1.x gets fixes until at least 2028-12-31."
+---
+
# Release Notes
---
diff --git a/docs/dev-guide/README.md b/docs/dev-guide/README.md
index 183365e0..6944b24b 100644
--- a/docs/dev-guide/README.md
+++ b/docs/dev-guide/README.md
@@ -1,3 +1,7 @@
+---
+description: "Documentation for developers of MkDocs themes and plugins."
+---
+
# Developer Guide
Extending MkDocs
diff --git a/docs/dev-guide/api.md b/docs/dev-guide/api.md
index bc2c85fd..9c8a1aff 100644
--- a/docs/dev-guide/api.md
+++ b/docs/dev-guide/api.md
@@ -1,3 +1,7 @@
+---
+description: "Reference for the MkDocs Python API used by plugins, themes and scripts: configuration, files, pages, navigation and build functions."
+---
+
# API reference
NOTE: The main entry point to the API is through [Events](plugins.md#events) that are received by plugins. These events' descriptions link back to this page.
diff --git a/docs/dev-guide/plugins.md b/docs/dev-guide/plugins.md
index d3c9eb7b..405902db 100644
--- a/docs/dev-guide/plugins.md
+++ b/docs/dev-guide/plugins.md
@@ -1,3 +1,7 @@
+---
+description: "How to install, use and write MkDocs plugins, with every plugin event and the order in which they run."
+---
+
# MkDocs Plugins
A Guide to installing, using and creating MkDocs Plugins
diff --git a/docs/dev-guide/themes.md b/docs/dev-guide/themes.md
index d3cdacc7..72ab5a5c 100644
--- a/docs/dev-guide/themes.md
+++ b/docs/dev-guide/themes.md
@@ -1,3 +1,7 @@
+---
+description: "How to create, package and distribute a custom MkDocs theme, with the template variables themes can use."
+---
+
# Developing Themes
A guide to creating and distributing custom themes.
diff --git a/docs/dev-guide/translations.md b/docs/dev-guide/translations.md
index 3fdeaace..3f4cc70d 100644
--- a/docs/dev-guide/translations.md
+++ b/docs/dev-guide/translations.md
@@ -1,3 +1,7 @@
+---
+description: "How to add or update translations of the built-in MkDocs themes."
+---
+
# Translations
Theme localization guide.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 16afbc95..2614aa6e 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -1,3 +1,7 @@
+---
+description: "Install MkDocs NG, create a site, preview it as you write and build it, in a few minutes."
+---
+
# Getting Started with MkDocs
An introductory tutorial!
diff --git a/docs/hooks.py b/docs/hooks.py
index 76e4ac4b..b736bf90 100644
--- a/docs/hooks.py
+++ b/docs/hooks.py
@@ -28,6 +28,7 @@
ISSUE_REF_RE = re.compile(r"(?\d+)\b")
VERSION_EXAMPLE_RE = re.compile(r"mkdocs, version \S+ from")
COMPAT_CASES_MARKER = ""
+MARKDOWN_SNIPPET_RE = re.compile(r'^--8<-- "([^"]+\.md)"[ \t]*$', re.MULTILINE)
COMPAT_CASES_PATH = Path(__file__).resolve().parents[1] / "compat" / "cases.yaml"
@@ -149,9 +150,20 @@ def on_config(config: MkDocsConfig) -> None:
_fix_cli_page_defaults()
+def _inline_markdown_snippets(markdown: str, root: Path) -> str:
+ # Pages that only include a Markdown file from the repository, such as
+ # .github/GOVERNANCE.md, get its text here instead of through
+ # pymdownx.snippets, so that their Markdown copy for llms.txt has it too.
+ return MARKDOWN_SNIPPET_RE.sub(
+ lambda m: Path(root, m[1]).read_text(encoding="utf-8"), markdown
+ )
+
+
def on_page_markdown(
markdown: str, page: Page, config: MkDocsConfig, **kwargs
) -> str | None:
+ markdown = _inline_markdown_snippets(markdown, Path(config.config_file_path).parent)
+
if page.file.src_uri == "about/release-notes.md":
return _rewrite_release_notes_links(_update_version_example(markdown))
@@ -176,3 +188,5 @@ def replacement(m: re.Match) -> str:
markdown,
flags=re.MULTILINE,
)
+
+ return markdown
diff --git a/docs/img/social.png b/docs/img/social.png
new file mode 100644
index 0000000000000000000000000000000000000000..4f575c29d0f11168f3d5b4aaccaf128f00cd2727
GIT binary patch
literal 75869
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