{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"}],"enrichment":{"capability":"A MkDocs plugin that fetches and embeds markdown content or specific sections from external URLs directly into your documentation pages using Jinja2 template syntax.","skillfed_tags":["mkdocs-plugin","content-reuse","documentation-automation"],"use_cases":["Keep installation or configuration instructions in a central repository and embed them in multiple documentation sites without duplication.","Build a documentation hub that pulls README sections from different project repositories into a unified guide.","Embed changelog or API documentation from external sources into your MkDocs site without manual copying.","Document Ansible playbooks or Django templates by embedding code examples from live repositories while protecting them from Jinja2 interpretation.","Maintain single-source-of-truth documentation by referencing sections from GitHub private repositories using a personal access token."],"what_it_does":"This is a MkDocs plugin that extends your documentation build process to pull markdown content from external URLs and inject it directly into your pages. It works by parsing Jinja2 template syntax in your markdown files\u2014you specify a URL and optionally a section header (like '## Installation'), and the plugin fetches that content and embeds it at build time. The plugin strips top-level headers from embedded content so you can use your own, and it supports extracting specific sections defined by markdown headers at any level.\n\nThe plugin depends on Jinja2 (for template rendering) and requests (for fetching URLs). It can authenticate with private GitHub repositories if you set the GH_TOKEN environment variable. A known gotcha: if your markdown contains Jinja2-like syntax (common in code examples documenting template languages, Ansible, or Django), you need to wrap those blocks in `{% raw %}` tags to prevent the plugin from trying to interpret them as macros.","worth_installing":"Yes, if you need to embed external markdown into MkDocs and can tolerate aging maintenance. The plugin is stable (no known vulnerabilities, low install friction, permissive license), but the 900-day gap since the last release means new MkDocs features or Python versions may not be supported. Install it for straightforward content embedding, but monitor the repository for compatibility issues with your MkDocs version."},"id":"mkdocs-embed-external-markdown","links":{"html":"https://skillfed.io/packages/mkdocs-embed-external-markdown","md":"https://skillfed.io/packages/mkdocs-embed-external-markdown.md","pypi":"https://pypi.org/project/mkdocs-embed-external-markdown/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2024-02-26","license_spdx":null,"license_treatment":"permissive","name":"mkdocs-embed-external-markdown","python_support":"supports_current","summary":"Mkdocs plugin that allow to inject external markdown or markdown section from given url"},"popularity":{"monthly_downloads":108786,"position":12539,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"3.0.2"}