mkdocs-git-authors-plugin
Mkdocs plugin to display git authors of a page
Decision gist · record as of 2026-08-14
Yes, if you use MkDocs and want automatic author attribution from git history. The plugin is lightweight, permissively licensed, and carries no security vulnerabilities. The aging maintenance status (430 days since release) is a minor concern but the repository remains active and supports current Python versions. Ensure your build environment is configured to fetch full git history, or author data will be incomplete.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires full git history access; shallow clones in CI/CD will return incomplete author data unless fetch_depth/GIT_DEPTH is set to 0.
- Low friction installation as a pure Python wheel with a single runtime dependency on mkdocs.
- The project is aging (430 days since last release) but remains actively maintained with recent commits and no archived status.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and commercial projects.
last release 2025-06-10 (430 days) · last repo commit 2025-06-10 · 118 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 388,940 downloads/mo, #7,033 on PyPI
Alternatives
Verify before relying
pip install mkdocs-git-authors-plugin
# In mkdocs.yml:
plugins:
- search
- git-authors
# In markdown:
{{ git_page_authors }}- Whether the plugin correctly handles files with no git history or newly added files
- Performance impact on documentation builds with many pages or large git histories
- Compatibility with MkDocs theme customization beyond the documented {{ git_page_authors }} tag
What it is and what it does
This is a lightweight MkDocs plugin that integrates git history into your documentation by showing which authors last modified the current lines of a markdown page. It uses git blame to identify surviving code—the lines that remain in the file—and displays the authors responsible for them. You add it to your MkDocs configuration, then use the {{ git_page_authors }} template tag or customize your theme to show author attribution.
The plugin requires access to full git history to work correctly, which matters in CI/CD environments where shallow clones are common. The fact sheet notes that GitHub Actions, GitLab, and Bitbucket pipelines need specific configuration to fetch the full history (fetch_depth: 0, GIT_DEPTH: 0, or clone: depth: full respectively). It supports Python 3.8 through 3.13 and carries no known security vulnerabilities.
Use it for
- Add author attribution to documentation pages to track who last modified each section
- Generate contributor lists for collaborative documentation projects without manual maintenance
- Display authorship in CI/CD-built documentation sites by configuring shallow clone depth
- Customize MkDocs themes to show git authors alongside revision dates using companion plugins
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use MkDocs and want automatic author attribution from git history.
The plugin is lightweight, permissively licensed, and carries no security vulnerabilities. The aging maintenance status (430 days since release) is a minor concern but the repository remains active and supports current Python versions. Ensure your build environment is configured to fetch full git history, or author data will be incomplete.
Install
mkdocs-git-authors-plugin on PyPI
Before you install
Low friction installation as a pure Python wheel with a single runtime dependency on mkdocs. The project is aging (430 days since last release) but remains actively maintained with recent commits and no archived status.
Requires full git history access; shallow clones in CI/CD will return incomplete author data unless fetch_depth/GIT_DEPTH is set to 0.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and commercial projects.
Quickstart
pip install mkdocs-git-authors-plugin
# In mkdocs.yml:
plugins:
- search
- git-authors
# In markdown:
{{ git_page_authors }}Verify before relying
- Whether the plugin correctly handles files with no git history or newly added files
- Performance impact on documentation builds with many pages or large git histories
- Compatibility with MkDocs theme customization beyond the documented {{ git_page_authors }} tag
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagemkdocs |
| Maintenance | Aging 430 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 388,940 / month, #7,033 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: DocumentationTopic :: Text Processing |
Evidence: mkdocs_git_authors_plugin-0.10.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “mkdocs git authors plugin”
- mkdocs-git-authors-pluginA MkDocs plugin that extracts and displays the git authors of the…
- mkdocs-git-committers-plugin-2MkDocs plugin that fetches and displays a list of contributors to…
- mkdocs-git-revision-date-pluginAdds a Git-based revision date to MkDocs documentation pages,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Text Processing packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyparsing provides a library for building text parsers directly in Python code using composable grammar classes, handling quoted strings, whitespace variation, and embedded comments without regex or lex/yacc.
Install it if you need to parse text or define grammars programmatically.
fonttools manipulates font files in multiple formats (TrueType, OpenType, AFM, Type 1, Mac-specific) and includes TTX, a tool to convert fonts to and from XML text format.
Install it if you need to read, write, or manipulate fonts programmatically or via the TTX command-line tool.
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
RapidFuzz provides fast fuzzy string matching using Levenshtein Distance and related metrics, implemented mostly in C++ with Python bindings for rapid similarity scoring and approximate string matching.
Install it if you need fuzzy string matching; it's a solid replacement for FuzzyWuzzy with better licensing and performance.
tinycss2 parses CSS strings into token and block objects, and generates CSS strings from those objects, following the CSS Syntax Level 3 specification without enforcing specific properties or values.
Install it if your project requires CSS tokenization or syntax manipulation.
See also mkdocs-git-committers-plugin-2 · mkdocs-git-revision-date-localized-plugin · mkdocs-git-revision-date-plugin · mkdocs-print-site-plugin · mkdocs · mkdocs-video · mkdocs-markdownextradata-plugin · mkdocs-include-markdown-plugin · mkdocs-table-reader-plugin · git-me-the-url