{"categories":[{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/17"}],"enrichment":{"capability":"An mdformat plugin that formats Markdown for MkDocs projects, handling MkDocs-specific syntax like admonitions, content tabs, definition lists, and math notation while standardizing indentation and list formatting.","skillfed_tags":["mkdocs-plugin","markdown-formatter","documentation-tooling"],"use_cases":["Format documentation projects using MkDocs Material with consistent indentation and list styles across all Markdown files.","Normalize admonitions, content tabs, and definition lists in Material for MkDocs docs while preserving their semantic meaning.","Standardize math notation (LaTeX and dollar-sign blocks) in technical documentation built with MkDocs.","Integrate into pre-commit hooks or CI pipelines to enforce Markdown style consistency for mkdocs-based projects.","Preserve mkdocstrings injection blocks and cross-references during automated Markdown reformatting."],"what_it_does":"mdformat-mkdocs is a plugin for the mdformat Markdown formatter that adds awareness of MkDocs-specific and Material for MkDocs syntax. It standardizes Markdown formatting (four-space indents, dash-based unordered lists, single-digit ordered list markers by default) while preserving or actively formatting MkDocs extensions like admonitions, content tabs, definition lists, mkdocstrings injection blocks and cross-references, and math notation via dollarmath, texmath, and amsmath.\n\nThe plugin integrates seamlessly into any mdformat workflow\u2014it auto-registers and requires no configuration. It handles both explicit formatting (admonitions with extra spacing for consistency with mkdocs styleguide, math block normalization) and implicit pass-through of PyMdown extensions like emoji, critic markup, and inline highlighting. It also supports optional extras for recommended companion formatters and provides flags like --no-mkdocs-math to disable math formatting and --ignore-missing-references to preserve ProgressBar syntax.","worth_installing":"Yes. Active maintenance, no vulnerabilities, low install friction, and permissive MIT license make this a safe choice. Install it if you format Markdown in MkDocs or Material for MkDocs projects and want a formatter that understands your project's syntax without corrupting extensions. Skip it if you don't use MkDocs or have no need for automated Markdown formatting."},"id":"mdformat-mkdocs","links":{"html":"https://skillfed.io/packages/mdformat-mkdocs","md":"https://skillfed.io/packages/mdformat-mkdocs.md","pypi":"https://pypi.org/project/mdformat-mkdocs/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-08-02","license_spdx":"MIT","license_treatment":"permissive","name":"mdformat-mkdocs","python_support":"supports_current","summary":"An mdformat plugin for mkdocs and Material for MkDocs"},"popularity":{"monthly_downloads":158177,"position":10733,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"5.3.0"}