{"library":"mkdocs-material-extensions","title":"MkDocs Material Extensions","description":"This library, `mkdocs-material-extensions`, provides an extension pack for Python Markdown specifically designed to work with the MkDocs Material theme. As of version 1.3 (released November 2023), this project is deprecated and considered obsolete because its core logic has been integrated directly into `mkdocs-material` (version 9.4 and above). Users are strongly advised to migrate to the equivalent functionalities provided by `mkdocs-material` itself. It primarily facilitated inline SVG icons and emoji handling within MkDocs Material documentation.","status":"deprecated","version":"1.3.1","language":"en","source_language":"en","source_url":"https://github.com/facelessuser/mkdocs-material-extensions","tags":["MkDocs","Markdown","extensions","emoji","documentation","deprecated"],"install":[{"cmd":"pip install mkdocs-material-extensions","lang":"bash","label":"Pip Install"}],"dependencies":[{"reason":"This library was designed to extend MkDocs Material. As of v1.0.2, MkDocs Material handles the dependency management for this library, implicitly pulling it in when needed.","package":"mkdocs-material","optional":false}],"imports":[{"note":"This was the YAML reference for the custom emoji index in `mkdocs.yml`. It is now superseded by `!!python/name:material.extensions.emoji.twemoji` within `mkdocs-material` versions 9.4 and later.","wrong":"from materialx.emoji import twemoji","symbol":"twemoji (for YAML config)","correct":"!!python/name:materialx.emoji.twemoji"},{"note":"This was the YAML reference for the custom emoji generator in `mkdocs.yml`. It is now superseded by `!!python/name:material.extensions.emoji.to_svg` within `mkdocs-material` versions 9.4 and later.","wrong":"from materialx.emoji import to_svg","symbol":"to_svg (for YAML config)","correct":"!!python/name:materialx.emoji.to_svg"}],"quickstart":{"code":"# mkdocs.yml (Deprecated configuration for mkdocs-material-extensions)\nmarkdown_extensions:\n  - pymdownx.emoji:\n      emoji_index: !!python/name:materialx.emoji.twemoji\n      emoji_generator: !!python/name:materialx.emoji.to_svg\n\n# --- MIGRATION PATH for MkDocs Material v9.4+ (mkdocs.yml) ---\n# Remove `mkdocs-material-extensions` from your project dependencies.\n# Update your mkdocs.yml to use the native extensions provided by mkdocs-material:\n# markdown_extensions:\n#   - pymdownx.emoji:\n#       emoji_index: !!python/name:material.extensions.emoji.twemoji\n#       emoji_generator: !!python/name:material.extensions.emoji.to_svg\n","lang":"yaml","description":"This quickstart demonstrates the *deprecated* configuration of `mkdocs-material-extensions` in your `mkdocs.yml` file, primarily for enabling inline SVG icons and emoji. The library is now obsolete, and its functionality is integrated directly into `mkdocs-material`. The commented section shows the required changes to migrate your configuration to `mkdocs-material` versions 9.4 and above."},"warnings":[{"fix":"Remove `mkdocs-material-extensions` from your project dependencies (`pip uninstall mkdocs-material-extensions`). Update your `mkdocs.yml` to use `material.extensions.emoji.twemoji` and `material.extensions.emoji.to_svg` instead of `materialx.emoji.*` references.","message":"This library is deprecated and obsolete since `mkdocs-material` version 9.4, which now includes this library's functionality directly. Users *must* migrate their `mkdocs.yml` configuration from `materialx.emoji.twemoji` and `materialx.emoji.to_svg` to `material.extensions.emoji.twemoji` and `material.extensions.emoji.to_svg` respectively. Continuing to use this library with `mkdocs-material` versions 9.4+ may lead to unexpected behavior or build issues.","severity":"breaking","affected_versions":"1.3 and later of `mkdocs-material-extensions` when used with `mkdocs-material` 9.4 and later."},{"fix":"Upgrade your Python environment to 3.8 or higher.","message":"Support for Python 3.6 was dropped in version 1.1, and Python 3.7 support was removed in version 1.2. Users on these older Python environments will need to upgrade to Python 3.8 or higher to use newer versions of `mkdocs-material-extensions` or the integrated functionality in `mkdocs-material`.","severity":"deprecated","affected_versions":"1.1, 1.2"},{"fix":"Ensure `mkdocs-material` is installed; typically, `mkdocs-material-extensions` will be pulled in as a transitive dependency if needed. Avoid explicit dependency on `mkdocs-material-extensions` unless absolutely necessary for specific version pinning scenarios, especially with older `mkdocs-material` versions.","message":"Version 1.0.2 addressed a circular dependency issue where `mkdocs-material-extensions` listed `mkdocs-material` as a dependency, while `mkdocs-material` also depended on `mkdocs-material-extensions`. While `pip` handled this, some other versioning tools experienced issues. `mkdocs-material` now manages the necessary version of this library directly, so explicit installation of `mkdocs-material-extensions` is usually not required unless troubleshooting or working with very specific, older setups.","severity":"gotcha","affected_versions":"Prior to 1.0.2"}],"env_vars":null,"last_verified":"2026-04-05T00:00:00.000Z","next_check":"2026-07-04T00:00:00.000Z"}