{"categories":[{"label":"Markup","url":"https://skillfed.io/packages/category/text-processing-markup/2"},{"label":"Filters","url":"https://skillfed.io/packages/category/text-processing-filters"}],"enrichment":{"capability":"A Markdown extension that embeds local or remote files into Markdown documents at specified positions, with support for recursive inclusion, file slicing, and content caching.","skillfed_tags":["markdown-extension","documentation-tooling"],"use_cases":["Include code examples from source files into API documentation, keeping examples in sync with actual code.","Build modular documentation by including shared sections (e.g., common setup steps) into multiple markdown files.","Embed test fixtures or sample data files into markdown test reports or guides without manual copy-paste.","Fetch and embed remote markdown or text files into a local document during build time.","Slice and include only relevant portions of large files (e.g., a specific function from a source file) using line/column ranges."],"what_it_does":"mdx_include is a Markdown extension that lets you insert the contents of local files or remote URLs directly into your Markdown documents using a simple brace syntax like `{! file.md !}`. It handles recursive inclusion (files can include other files), file slicing by line and column ranges, content caching to avoid re-reading the same file multiple times, and circular inclusion detection. The extension depends on Markdown, rcslice for line/column slicing, and cyclic for circular dependency detection.\n\nThe package is motivated by an earlier markdown-include project but adds features like per-inclusion recursion control, indentation preservation, and configurable syntax delimiters. It's designed for documentation workflows where you want to keep content DRY by including shared snippets or examples from source files. Configuration options let you control recursion depth, encoding, caching behavior, and whether to allow local vs. remote includes.","worth_installing":"Yes, if you need file inclusion in Markdown and can tolerate dormant maintenance. The package is stable and has no known vulnerabilities, but it has not been updated since mid-2022. Install it for documentation tooling where you want to embed local or remote files, but do not expect active support or updates for new Markdown or Python versions."},"id":"mdx-include","links":{"html":"https://skillfed.io/packages/mdx-include","md":"https://skillfed.io/packages/mdx-include.md","pypi":"https://pypi.org/project/mdx-include/"},"maintenance":{"status":"dormant"},"meta":{"latest_release":"2022-07-26","license_spdx":null,"license_treatment":"permissive","name":"mdx-include","python_support":"unspecified","summary":"Python Markdown extension to include local or remote files"},"popularity":{"monthly_downloads":128762,"position":11695,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"1.4.2"}