v1.7.3

Version 1.7.3 (2026-05-09)

Fixed

• Fix CLI default handling with recent Click versions so omitted options do not override configured strict, use_directory_urls, or serve reload mode values. #60
• Fix livereload triggering unnecessary rebuilds for editor temporary files (vim swap, tilde backups, Emacs auto-save). #55
• Handle edge-case markup (such as <<>>) that could crash the build due to AssertionError in Python's html.parser. #51
• Strip HTML tags from search entry titles, preventing raw HTML from appearing in search results. #53

Added

• Expose page.content_title property for plugin authors to access the first heading text from rendered page content with HTML tags stripped. #52

Maintenance

• Add mypy type checking to pre-commit hooks. #57
• Update pip dependency group. #58
• Remove "type of change" section from pull request template.

---

Canonical release notes: https://mkdocs-ng.github.io/mkdocs/about/release-notes/

v1.7.2

Version 1.7.2 (2026-04-27)

Fixed

• Fix dropdown submenu arrow invisible in the navigation menu. #44
• Fix malformed URLs (e.g., unterminated IPv6 literals) crashing the entire build. #45
• Fix build crash caused by broken (dangling) symlinks in the docs directory. #46 #43

Maintenance

• Add concurrency settings to CI workflows so redundant in-progress jobs are cancelled when new pushes occur. #47

---

Canonical release notes: https://mkdocs-ng.github.io/mkdocs/about/release-notes/

v1.7.1

Version 1.7.1 (2026-04-25)

Fixed

• Fix anchor link validation so mkdocs build -v --strict still fails when missing anchors are reported as warnings. #30
• Fix validation.links.not_found is always reported as INFO for excluded pages. #32
• Fix mkdocs serve cleanup so temporary site directories are removed when the process receives SIGTERM. #36
• Fix mkdocs theme color mode switching when highlightjs is disabled. #39

Maintenance

• Remove the unmaintained mergedeep dependency by replacing it with an internal deep-merge helper. #29
• Add a generate-release-note skill and AGENTS.md for maintaining the project. #35
• Upgrade PyPy from 3.9 to 3.11 to fix CI failure and add PR auto-labeler workflow to automatically tag incoming PRs. #37

---

Canonical release notes: https://mkdocs-ng.github.io/mkdocs/about/release-notes/

v1.7.0

Version 1.7.0 (2026-04-24)

MkDocs NG 1.7.0 is a small but important release. The biggest change is that
the package is now published on PyPI as mkdocs-ng, while the command-line
interface remains mkdocs.

This is the first release maintained under the MkDocs NG fork, so the focus is
maintenance infrastructure rather than new end-user features.

Upgrade notes

Install or upgrade with:

pip install -U mkdocs-ng

The CLI command does not change, so existing commands such as mkdocs serve,
mkdocs build, and mkdocs gh-deploy continue to work as before.

If you maintain setup instructions, templates, or CI snippets, update any old
references to the previous package name or project URLs.

Highlights

• The PyPI package name is now mkdocs-ng. Repository, documentation, and installation references were updated to the MkDocs NG project locations. #2 #12 #15
• Fix mkdocs serve --livereload so the option is recognized correctly again. #4
• Add Python 3.13 and 3.14 to the tested and declared supported versions. #4

Maintenance

• Simplify contributor setup by removing the old pinned requirements files and moving repository-wide checks to shared pre-commit hooks. #14 #24
• Add issue templates, security workflow, Dependabot, and Release Drafter to improve maintenance and release management. #6 #7 #24
• Refresh GitHub Actions and pip dependency updates. #8 #10 #19

---

Canonical release notes: https://mkdocs-ng.github.io/mkdocs/about/release-notes/