mkdocs-meta-manager

What it is and what it does

mkdocs-meta-manager is a MkDocs plugin that centralizes meta tag management by reading `.meta.yml` configuration files placed at any level in your docs folder structure. Instead of manually adding meta tags to every markdown file, you define them once in a meta file, and all markdown files in that folder and its subfolders automatically inherit those tags. The plugin supports customizing the meta filename and merging entries from multiple meta files according to the folder hierarchy.

It's designed for documentation sites that need consistent metadata (like SEO tags, author info, or custom attributes) applied across many pages without repetition. The plugin integrates directly into MkDocs' build pipeline and depends only on mkdocs and jinja2, making it lightweight to install and run.

Use it for:

• Apply consistent SEO meta tags (description, keywords, og:image) to all pages in a documentation section without editing each file
• Set author, version, or custom metadata at the folder level so all nested pages inherit the same attributes
• Manage documentation-wide metadata like language, robots directives, or tracking codes from a single configuration point
• Override inherited meta tags at deeper folder levels to customize metadata for specific documentation subsections
• Reduce boilerplate by defining common meta patterns once and reusing them across multiple documentation projects

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A MkDocs plugin that automatically applies meta tags to markdown files based on hierarchical `.meta.yml` configuration files placed in your docs folder structure.

Yes, if you use MkDocs and need to manage meta tags across many pages. The plugin is lightweight, has no security vulnerabilities, and MIT licensing poses no restrictions. However, dormant maintenance (571 days since last release) means you should verify compatibility with your MkDocs version before relying on it for production—test thoroughly and be prepared to fork or maintain it yourself if updates become necessary.

Install

mkdocs-meta-manager on PyPI

pip install mkdocs-meta-manager

uv add mkdocs-meta-manager

poetry add mkdocs-meta-manager

Installing mkdocs-meta-manager

Before you install

Installs cleanly with only mkdocs and jinja2 as runtime dependencies. Dormant maintenance status (last commit 2025-01-20, no activity for 571 days) means bug fixes and compatibility updates are unlikely, though the small scope and stable dependencies reduce risk.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install mkdocs-meta-manager

# In mkdocs.yml:
plugins:
  - search
  - meta-manager

# Create .meta.yml in your docs folder:
# meta:
#   - name: description
#     content: "Page description"

# All markdown files in that folder and subfolders inherit these tags

Verify before relying

• Whether dormant status (571 days since last release) affects compatibility with recent MkDocs versions
• Performance impact when managing meta tags across large documentation hierarchies
• Behavior when meta files conflict or overlap across nested folder structures

Package facts

Evidence: mkdocs_meta_manager-1.1.0-py3-none-any.whl

Keywords: mkdocs, meta, manager

Tags

More Text Processing packages