Use when creating, configuring, fixing, or deploying MkDocs / Material for MkDocs documentation sites - especially when task-list checkboxes render as literal "[ ]" text, bare URLs are not clickable, tables overflow the page width, Mermaid diagrams show as plain code blocks, mkdocs gh-deploy succeeds but GitHub Pages shows errors or a 404, or an internal/private repo's Pages URL is unclear. Covers mkdocs.yml configuration, pymdownx extensions, navigation, strict builds, and GitHub Pages deployment.
2026-07-02