{"library":"mkdocs-table-reader-plugin","title":"MkDocs Table Reader Plugin","description":"mkdocs-table-reader-plugin is an MkDocs plugin designed to directly insert tables from various file formats (like CSV, Excel, JSON, YAML, Feather) into Markdown documentation. It is currently at version 3.1.0 and is actively maintained with regular updates and improvements.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install mkdocs-table-reader-plugin"],"cli":null},"imports":["plugins:\n  - table-reader:"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"mkdocs.yml:\n```yaml\nsite_name: My Data Docs\nplugins:\n  - search\n  - table-reader\n\n# Optional: Configure data_path if all your tables are in one directory\n# plugins:\n#   - table-reader:\n#       data_path: assets/tables\n```\n\ndocs/data/my_table.csv:\n```csv\nHeader1,Header2\nValue1,ValueA\nValue2,ValueB\n```\n\ndocs/index.md:\n```markdown\n# My Report\n\nHere is some data from a CSV file:\n\n{{ read_csv('data/my_table.csv') }}\n\nAnd another one, specifying pandas options:\n\n{{ read_csv('data/my_table.csv', sep=',', header=0) }}\n\n```","lang":"yaml+markdown","description":"This quickstart demonstrates how to enable the `mkdocs-table-reader-plugin` in your `mkdocs.yml` and use the `read_csv` macro to embed a table from a CSV file into your Markdown documentation. Create a `mkdocs.yml` file, a sample CSV file in `docs/data/`, and a Markdown file (`docs/index.md`) with the `{{ read_csv(...) }}` tag.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"3.1.0","pypi_latest":"3.1.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":9,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"179.2M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":8.6,"import_time_s":null,"mem_mb":null,"disk_size":"172M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"193.2M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":8.3,"import_time_s":null,"mem_mb":null,"disk_size":"186M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"178.2M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":8.7,"import_time_s":null,"mem_mb":null,"disk_size":"171M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"177.2M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":8.7,"import_time_s":null,"mem_mb":null,"disk_size":"170M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"187.2M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mkdocs-table-reader-plugin","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":10.5,"import_time_s":null,"mem_mb":null,"disk_size":"183M"}]}}