{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"},{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"},{"label":"Markdown","url":"https://skillfed.io/packages/category/text-processing-markup-markdown"}],"enrichment":{"capability":"MkDocs plugin that lets you define site navigation as Markdown lists instead of YAML, with support for wildcards, cross-linked subdirectories, and inferred page ordering.","skillfed_tags":["mkdocs-plugin","documentation-tooling"],"use_cases":["Organize documentation where navigation structure mirrors the file layout, using Markdown lists instead of maintaining separate YAML config.","Build large doc sites with mixed explicit ordering (for important pages) and wildcard patterns (for auto-discovered content).","Create GitHub-friendly documentation where the nav file (e.g., README.md) displays nicely in the repository while also serving as MkDocs navigation.","Manage multi-section documentation where each subdirectory maintains its own navigation file independently.","Migrate from awesome-pages to a more explicit, Markdown-first navigation model."],"what_it_does":"mkdocs-literate-nav is a MkDocs plugin that replaces the YAML-based nav configuration with Markdown lists. Instead of maintaining a separate nav structure in mkdocs.yml, you write a SUMMARY.md file (or any other Markdown file you choose) containing nested bullet-point lists of links, and the plugin parses it to build your site's navigation tree.\n\nThe plugin supports several advanced features: wildcards to match files by pattern, cross-linked subdirectories where each folder can have its own SUMMARY.md, and inferred page ordering that falls back to MkDocs' default behavior when pages aren't explicitly listed. It works well alongside section-index and gen-files plugins, and is designed as a more explicit alternative to awesome-pages. The approach is intentionally opposite to awesome-pages\u2014only directories explicitly mentioned in parent nav files trigger implicit resolution of subdirectories.","worth_installing":"Yes. The plugin is actively maintained, has no known vulnerabilities, installs with low friction, and uses a permissive MIT license. It solves a genuine pain point\u2014writing navigation as Markdown instead of YAML\u2014and integrates well with the MkDocs ecosystem. Install it if your documentation benefits from Markdown-based nav or if you want finer control over page ordering without maintaining parallel YAML config."},"id":"mkdocs-literate-nav","links":{"html":"https://skillfed.io/packages/mkdocs-literate-nav","md":"https://skillfed.io/packages/mkdocs-literate-nav.md","pypi":"https://pypi.org/project/mkdocs-literate-nav/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-03-16","license_spdx":"MIT","license_treatment":"permissive","name":"mkdocs-literate-nav","python_support":"supports_current","summary":"MkDocs plugin to specify the navigation in Markdown instead of YAML"},"popularity":{"monthly_downloads":1287518,"position":4108,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"0.6.3"}