{"categories":[{"label":"Software Development","url":"https://skillfed.io/packages/category/software-development/2"},{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/2"},{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"},{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"}],"enrichment":{"capability":"A MkDocs plugin that automatically creates cross-page links to headings and anchors by reference name, without requiring you to know or specify the destination page path.","skillfed_tags":["mkdocs-plugin","documentation-linking","cross-references"],"use_cases":["Link to API documentation headings from multiple pages without hardcoding relative paths that break when pages move.","Create stable reference aliases for headings that appear in multiple OS-specific or version-specific documentation pages.","Build documentation that references generated API docs (e.g., from mkdocstrings) by heading name rather than computed file paths.","Simplify cross-references in large documentation sites where page structure is nested or frequently reorganized.","Add custom anchor points in the middle of documents and reference them from anywhere without knowing the source file location."],"what_it_does":"mkdocs-autorefs is a MkDocs plugin that extends the documentation linking model by allowing you to reference headings and anchors by their title alone, without needing to know or specify the file path of the target page. Normally in MkDocs you must write explicit relative or absolute paths to link between pages; this plugin indexes all headings and custom anchors across your site and resolves reference-style links like `[text][heading-name]` to the correct destination automatically.\n\nThe plugin handles several real-world complications: when the same heading appears on multiple pages, it logs a warning and uses the first match, or you can enable `resolve_closest` to pick the heading nearest to the current page. It supports custom Markdown anchors using the `attr_list` extension syntax, allowing you to create unique aliases for headings and link to them from anywhere. It also integrates with Material for MkDocs' instant preview feature by conditionally setting link title attributes. The plugin requires Python 3.9 or later and depends on Markdown, markupsafe, and mkdocs.","worth_installing":"Yes, if you use MkDocs and need to create cross-page links without managing explicit file paths. The plugin is stable (Development Status Beta), has no known vulnerabilities, and low install friction. The aging maintenance status (185 days since last release) is not a blocker for a mature plugin with a clear, focused scope, but verify it works with your MkDocs version before relying on it for production documentation."},"id":"mkdocs-autorefs","links":{"html":"https://skillfed.io/packages/mkdocs-autorefs","md":"https://skillfed.io/packages/mkdocs-autorefs.md","pypi":"https://pypi.org/project/mkdocs-autorefs/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2026-02-10","license_spdx":"ISC","license_treatment":"permissive","name":"mkdocs-autorefs","python_support":"supports_current","summary":"Automatically link across pages in MkDocs."},"popularity":{"monthly_downloads":8138045,"position":1659,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"1.4.4"}