{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"}],"enrichment":{"capability":"Injects mkdocs.yml extra variables into markdown files before rendering to HTML, allowing you to use template variables like {{ customer.name }} directly in your markdown content.","skillfed_tags":["mkdocs-plugin","template-variables","static-site-generation"],"use_cases":["Build multi-tenant documentation where client names, domains, or branding vary per build by storing them in extra variables.","Maintain a single markdown source with placeholder variables for URLs, API endpoints, or configuration values that differ per environment.","Organize large documentation projects by splitting context data into multiple YAML files in a _data directory and referencing them in markdown.","Avoid duplicating content across documentation versions by using variables to swap out version-specific URLs or feature names.","Customize Jinja2 syntax to prevent template conflicts when your markdown contains code examples or documentation about Jinja2 itself."],"what_it_does":"This is a MkDocs plugin that makes the `extra:` variables defined in your mkdocs.yml available as Jinja2 template variables directly within your markdown files. Instead of only being able to use variables in HTML templates, you can now reference them in your .md content\u2014useful for inserting client names, URLs, image paths, or other dynamic values that should vary across documentation builds.\n\nThe plugin supports both inline `extra:` configuration and external YAML/JSON data files. You can point it to one or more directories containing data files, and it will automatically load them and make their contents available as nested template variables. It also allows customization of Jinja2 delimiters and comment syntax, which helps when your markdown itself contains Jinja-like syntax that would otherwise collide with the template engine.","worth_installing":"Yes, if you need to inject dynamic values into markdown content during MkDocs builds. The package is stable, has low install friction, and solves a real gap in MkDocs' templating model. Dormant maintenance is a minor concern\u2014test compatibility with your MkDocs version before relying on it for production, but the simple scope and lack of security issues make it a low-risk choice."},"id":"mkdocs-markdownextradata-plugin","links":{"html":"https://skillfed.io/packages/mkdocs-markdownextradata-plugin","md":"https://skillfed.io/packages/mkdocs-markdownextradata-plugin.md","pypi":"https://pypi.org/project/mkdocs-markdownextradata-plugin/"},"maintenance":{"status":"dormant"},"meta":{"latest_release":"2024-08-22","license_spdx":null,"license_treatment":"permissive","name":"mkdocs-markdownextradata-plugin","python_support":"supports_current","summary":"A MkDocs plugin that injects the mkdocs.yml extra variables into the markdown template"},"popularity":{"monthly_downloads":119509,"position":12071,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.2.6"}
