{"categories":[{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/20"}],"enrichment":{"capability":"A plugin for mdformat that normalizes YAML, TOML, and JSON front matter in Markdown documents, with optional key sorting and strict validation modes.","skillfed_tags":["markdown-tooling","static-site-generators"],"use_cases":["Enforce consistent front matter formatting across a documentation site or blog built with a static site generator.","Validate and normalize YAML front matter in Jekyll, Hugo, or similar Markdown-based projects via pre-commit hooks.","Sort front matter keys alphabetically in CI/CD pipelines to reduce merge conflicts in version control.","Fail builds when front matter is malformed using strict mode in automated documentation workflows.","Normalize mixed YAML/TOML/JSON front matter in heterogeneous Markdown repositories to a single standard format."],"what_it_does":"mdformat-front-matters is a plugin that extends mdformat to recognize and normalize front matter (metadata blocks) in Markdown files. It handles three formats: YAML (delimited by `---`), TOML (delimited by `+++`), and JSON (block syntax). The plugin preserves the original key order by default but can sort keys alphabetically with a flag, and it includes a strict mode that fails on invalid front matter rather than silently preserving it.\n\nThe package is designed to work zero-configuration once installed alongside mdformat\u2014it auto-registers as a plugin. It depends on mdformat as its host, mdit-py-plugins for Markdown parsing integration, ruamel-yaml for YAML handling, and toml for TOML support. It's intended for developers managing Markdown documents with metadata, particularly in static site generators, documentation systems, or content pipelines where consistent front matter formatting matters.","worth_installing":"Yes, if you use mdformat and need to normalize front matter in Markdown files. Install friction is low, dependencies are stable, and the plugin is actively maintained. No known vulnerabilities. MIT license is permissive. The only caveat is that the repository is small and young (first release October 2025), so community adoption and long-term support are not yet proven."},"id":"mdformat-front-matters","links":{"html":"https://skillfed.io/packages/mdformat-front-matters","md":"https://skillfed.io/packages/mdformat-front-matters.md","pypi":"https://pypi.org/project/mdformat-front-matters/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-12-04","license_spdx":"MIT","license_treatment":"permissive","name":"mdformat-front-matters","python_support":"supports_current","summary":"An mdformat plugin to format YAML, TOML, or JSON front matter"},"popularity":{"monthly_downloads":96480,"position":13208,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"2.0.0"}