{"library":"mkdocs-material","title":"Material for MkDocs","description":"Material for MkDocs is a highly customizable and responsive theme for MkDocs, a static site generator for project documentation. It transforms plain Markdown files into a professional-looking website with features like search, navigation, and extensive customization options. As of November 2025, the project is in maintenance mode (version 9.7.0 being the last feature release), with critical bug fixes and security updates guaranteed until at least November 2026, as the development team shifts focus to a new project called Zensical.","status":"maintenance","version":"9.7.6","language":"en","source_language":"en","source_url":"https://github.com/squidfunk/mkdocs-material","tags":["documentation","static-site-generator","theme","markdown","mkdocs"],"install":[{"cmd":"pip install mkdocs-material","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Material for MkDocs is a theme built on top of MkDocs and requires it for functionality. It is explicitly incompatible with MkDocs 2.0 and requires MkDocs 1.x.","package":"mkdocs","optional":false}],"imports":[],"quickstart":{"code":"mkdocs new my-project\ncd my-project\n# Edit mkdocs.yml to apply the theme\nwith open('mkdocs.yml', 'w') as f:\n    f.write('site_name: My Documentation\\n')\n    f.write('theme:\\n')\n    f.write('  name: material\\n')\nmkdocs serve","lang":"bash","description":"Create a new MkDocs project, navigate into it, configure `mkdocs.yml` to use the Material theme, and then serve the documentation locally."},"warnings":[{"fix":"Plan for migration to alternatives (like Zensical) or ensure current features meet long-term needs within the support window.","message":"Material for MkDocs is in maintenance mode. No new features will be added, and critical bug/security fixes are planned only until at least November 2026. Users should consider migration paths or be aware of the limited support window. The team is focusing on a new project, Zensical.","severity":"deprecated","affected_versions":">=9.7.0"},{"fix":"Ensure `mkdocs` is explicitly pinned to a version less than 2 (e.g., `pip install mkdocs<2`).","message":"Material for MkDocs is incompatible with MkDocs 2.0. MkDocs 2.0 introduces backward-incompatible changes, including the removal/redesign of the plugin and theming systems. Users must pin their `mkdocs` dependency to `<2` to avoid breakage.","severity":"breaking","affected_versions":"All versions with MkDocs 2.0+"},{"fix":"Avoid using the `projects` and `typeset` plugins in new projects. For existing projects, be aware they will not receive updates or fixes.","message":"The `projects` and `typeset` plugins were deprecated in version 9.7.0. They are included for compatibility but are considered architectural dead ends and are provided without ongoing support.","severity":"deprecated","affected_versions":">=9.7.0"},{"fix":"Review the 'How to upgrade' guide in the official documentation and explicitly enable features that were previously implicit in your `mkdocs.yml` configuration. Update language codes if used.","message":"Upgrading from 8.x to 9.x requires configuration changes for several features that became opt-in. This includes `content.code.copy`, `content.action.*`, and `navigation.footer`. Language codes like `kr` and `no` were also renamed to `ko` and `nb` respectively.","severity":"breaking","affected_versions":"9.x (from 8.x)"},{"fix":"Ensure your Python environment is running version 3.8 or newer.","message":"Material for MkDocs requires Python >=3.8. Using older Python versions can lead to dependency conflicts, such as `urllib3 v2.0` requiring OpenSSL 1.1.1+, which might not be met by older Python distributions.","severity":"gotcha","affected_versions":"<3.8"}],"env_vars":null,"last_verified":"2026-04-05T00:00:00.000Z","next_check":"2026-07-04T00:00:00.000Z"}