mkdocs-task-collector
A MkDocs plugin to collect TODO, NOTE, and PLACEHOLDER annotations.
Decision gist · record as of 2026-08-14
Yes, if you use MkDocs and want to track embedded annotations automatically. The plugin is straightforward to set up, has no configuration overhead, and solves a real documentation-management problem. However, note that maintenance is aging (last release over a year ago), so consider whether you're comfortable with a package that may not receive rapid updates. No known vulnerabilities and permissive licensing make it low-risk to try.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with a single runtime dependency on mkdocs.
- Maintenance status is aging—last release was over a year ago (2024-08-11), though the repository remains active with a recent commit (2025-06-08) and no archived status.
License · maintenance · safety
permissive license (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
last release 2024-08-11 (733 days) · last repo commit 2025-06-08 · 6 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 195,621 downloads/mo, #9,811 on PyPI
Alternatives
Verify before relying
pip install mkdocs-task-collector
Add to mkdocs.yml:
plugins:
- task_collector:
output_file: 'tasks-list.md'
Add to nav section:
nav:
- Tasks: tasks-list.md
Run: mkdocs build- Whether the plugin correctly handles edge cases like quoted annotations (e.g., ``TODO``) as mentioned in the roadmap
- Whether generated task list links are clickable and point to specific files/lines, or if this remains a planned feature
What it is and what it does
mkdocs-task-collector is a MkDocs plugin that automatically extracts TODO, NOTE, and PLACEHOLDER annotations from your Markdown documentation and generates a consolidated task list. It runs during the MkDocs build process with zero configuration beyond adding it to your mkdocs.yml file, making it useful for tracking documentation work-in-progress items alongside your site.
The plugin scans all Markdown files, collects matching annotations with their source file and line number, and writes them to a configurable output file (typically tasks-list.md). The generated file can be included in your documentation navigation and is automatically updated on each build, both locally and in remote deployment environments like GitHub Pages.
Use it for
- Track TODO items embedded in documentation that need completion before publishing
- Maintain a centralized NOTE list across multiple documentation files for review
- Collect PLACEHOLDER markers indicating where diagrams, examples, or content should be inserted
- Audit documentation work-in-progress during the build process without manual scanning
- Generate a living task dashboard published alongside your documentation site
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use MkDocs and want to track embedded annotations automatically.
The plugin is straightforward to set up, has no configuration overhead, and solves a real documentation-management problem. However, note that maintenance is aging (last release over a year ago), so consider whether you're comfortable with a package that may not receive rapid updates. No known vulnerabilities and permissive licensing make it low-risk to try.
Install
mkdocs-task-collector on PyPI
Before you install
Low install friction with a single runtime dependency on mkdocs. Maintenance status is aging—last release was over a year ago (2024-08-11), though the repository remains active with a recent commit (2025-06-08) and no archived status.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.
Quickstart
pip install mkdocs-task-collector
Add to mkdocs.yml:
plugins:
- task_collector:
output_file: 'tasks-list.md'
Add to nav section:
nav:
- Tasks: tasks-list.md
Run: mkdocs buildVerify before relying
- Whether the plugin correctly handles edge cases like quoted annotations (e.g., ``TODO``) as mentioned in the roadmap
- Whether generated task list links are clickable and point to specific files/lines, or if this remains a planned feature
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagemkdocs |
| Maintenance | Aging 733 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 195,621 / month, #9,811 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: PluginsIntended Audience :: DevelopersLicense :: 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.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: DocumentationTopic :: Software Development :: Documentation |
Evidence: mkdocs_task_collector-0.1.14-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 plugin task collection”
- mkdocs-task-collectorA MkDocs plugin that scans Markdown files for TODO, NOTE, and…
- neoteroi-mkdocsProvides a collection of MkDocs plugins and Markdown extensions for…
- mkdocs-simple-hooksA MkDocs plugin that lets you define custom hooks directly in your…
Give your agent the search over MCP, or paste the wish link into any chat.
More Documentation packages
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
Griffe extracts the complete structure and signatures of Python programs to generate API documentation or detect breaking changes in your project's public API.
Install it if you need to programmatically inspect Python code structure, generate API docs, or enforce API stability in CI.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
See also mkdocs-gen-files · mkdocs-monorepo-plugin · mkdocs-awesome-pages-plugin · mkdocstrings · mkdocs-meta-manager · mkdocs-multirepo-plugin · mkdocs-table-reader-plugin · mkdocs-with-pdf · mkdocs-macros-plugin · mkdocs-video