Prepare v0.5.0 release

Bump package and docs config versions to 0.5.0, update changelog/security support.

Made-with: Cursor

Author: barcar

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-03-18
+
+### Added
+- Zensical compatibility shim: inject Zensical-parsed YAML front matter into `md.front_matter` so Jinja2 substitutions can use page metadata.
+- Tests covering the shim and the host-injected `md.front_matter` behavior.
+- Docs updates describing Zensical’s front matter stripping and the available compatibility path.
+
+### Fixed
+- Zensical: front matter variables are now available during Markdown Macros rendering even when the host strips the `---...---` block before Python-Markdown runs.
+
 ## [0.4.0] - 2026-03-07
 
 ### Added

CONTRIBUTING.md

@@ -44,7 +44,7 @@ Open a [GitHub issue](https://github.com/barcar/markdown-macros/issues) with:
 
 ## Releases
 
-Releases are cut by the maintainers. The version in `pyproject.toml` and [CHANGELOG.md](CHANGELOG.md) is the source of truth; the release tag (e.g. `v0.4.0`) must match. You don’t need to do anything special for a release when contributing.
+Releases are cut by the maintainers. The version in `pyproject.toml` and [CHANGELOG.md](CHANGELOG.md) is the source of truth; the release tag (e.g. `v0.5.0`) must match. You don’t need to do anything special for a release when contributing.
 
 ---
 

SECURITY.md

@@ -7,8 +7,8 @@ are currently being supported with security updates.
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 0.4.0  | :white_check_mark: |
-| < 0.4.0   | :x:                |
+| 0.5.0  | :white_check_mark: |
+| < 0.5.0   | :x:                |
 
 ## Reporting a Vulnerability
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "markdown-macros-extension"
-version = "0.4.0"
+version = "0.5.0"
 description = "Python-Markdown extension: MkDocs-Macros–style Jinja2 templating (variables, macros, filters) with YAML front matter for Zensical and MkDocs"
 readme = "README.md"
 license = "MIT"

zensical.toml

@@ -36,7 +36,7 @@ include_yaml = ["docs/demo_vars.yaml"]
 
 [project.markdown_extensions.markdown_macros.variables]
 site_name = "Markdown Macros"
-version = "0.4.0"
+version = "0.5.0"
 
 [project.markdown_extensions.admonition]
 [project.markdown_extensions.pymdownx.superfences]