{"categories":[{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"}],"enrichment":{"capability":"A MkDocs plugin that inserts tables from external files (CSV, JSON, Excel, YAML, and others) directly into markdown pages using template tags like `{{ read_csv('table.csv') }}`.","skillfed_tags":["mkdocs-plugin","data-driven-docs","table-embedding"],"use_cases":["Keep documentation tables synchronized with CSV or Excel source files without manual copy-paste","Build reproducible reports where tables update automatically when underlying data files change","Insert multiple tables from different file formats into a single MkDocs page using template tags","Combine with mkdocs-macros-plugin to filter or transform tables before rendering them in documentation","Generate data-driven documentation where tables are sourced from JSON or YAML configuration files"],"what_it_does":"mkdocs-table-reader-plugin extends MkDocs with a template tag system that reads tabular data from external files and renders them as markdown tables inline. Instead of manually copying table content into your documentation, you reference the file directly\u2014the plugin handles parsing CSV, JSON, Excel, YAML, TSV, and other formats, then inserts the rendered table into the page at build time.\n\nThe plugin depends on mkdocs, pandas, tabulate, and PyYAML to handle file reading and formatting. It integrates with MkDocs' plugin system and is compatible with mkdocs-macros-plugin for more advanced automation like filtering or batch-inserting directories of tables. The workflow is useful for keeping documentation synchronized with live data files or for building reproducible reports where tables update automatically when source files change.","worth_installing":"Yes, if you maintain MkDocs documentation that references external data files and want to keep tables synchronized automatically. The low install friction and permissive license make it a straightforward addition. However, note the aging maintenance status (715 days since last release)\u2014suitable for stable workflows but not for projects requiring active upstream support or frequent updates to MkDocs compatibility."},"id":"mkdocs-table-reader-plugin","links":{"html":"https://skillfed.io/packages/mkdocs-table-reader-plugin","md":"https://skillfed.io/packages/mkdocs-table-reader-plugin.md","pypi":"https://pypi.org/project/mkdocs-table-reader-plugin/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2024-08-29","license_spdx":null,"license_treatment":"permissive","name":"mkdocs-table-reader-plugin","python_support":"supports_current","summary":"MkDocs plugin to directly insert tables from files into markdown."},"popularity":{"monthly_downloads":234397,"position":9022,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"3.1.0"}