[](https://github.com/timvink/mkdocs-table-reader-plugin/actions)
[](https://codecov.io/gh/timvink/mkdocs-table-reader-plugin)
# mkdocs-table-reader-plugin
[MkDocs](https://www.mkdocs.org/) plugin that enables a markdown tag like `{{ read_csv('table.csv') }}` to directly insert various table formats into a page.
> For a workflow with other plugins see the blogpost [building reproducible reports with MkDocs](https://timvink.nl/reproducible-reports-with-mkdocs/)
## Installation
Install the plugin using `pip`:
```bash
pip install mkdocs-table-reader-plugin
```
Next, add the following lines to your `mkdocs.yml`:
```yml
plugins:
- search
- table-reader
```
> If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set.
## Usage
In your markdown files you can now use:
```html
{{ read_csv('path_to_table.csv') }}
```
Where the path is relative to the location of your project's `mkdocs.yml` file (although you can [change that](https://timvink.github.io/mkdocs-table-reader-plugin/options) to be relative to your `docs/` directory).
- There are [readers](https://timvink.github.io/mkdocs-table-reader-plugin/readers/) for `.csv`, `.fwf`, `.json`, `.xlsx`, `.yaml` and `.tsv` files. There is also the `read_raw()` reader that will allow you to insert tables (or other content) already in markdown format.
## Documentation and how-to guides
See [timvink.github.io/mkdocs-table-reader-plugin/](https://timvink.github.io/mkdocs-table-reader-plugin/)
Raw data
{
"_id": null,
"home_page": "https://github.com/timvink/mkdocs-table-reader-plugin",
"name": "mkdocs-table-reader-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mkdocs plugin",
"author": "Tim Vink",
"author_email": "vinktim@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2e/7f/d88dc4313c0abc3d9168d6018c830737bf08693ce45f87ab20a7ee799cb9/mkdocs_table_reader_plugin-2.2.1.tar.gz",
"platform": null,
"description": "[](https://github.com/timvink/mkdocs-table-reader-plugin/actions)\n\n\n\n[](https://codecov.io/gh/timvink/mkdocs-table-reader-plugin)\n\n\n\n# mkdocs-table-reader-plugin\n\n[MkDocs](https://www.mkdocs.org/) plugin that enables a markdown tag like `{{ read_csv('table.csv') }}` to directly insert various table formats into a page. \n\n> For a workflow with other plugins see the blogpost [building reproducible reports with MkDocs](https://timvink.nl/reproducible-reports-with-mkdocs/)\n\n## Installation\n\nInstall the plugin using `pip`:\n\n```bash\npip install mkdocs-table-reader-plugin\n```\n\nNext, add the following lines to your `mkdocs.yml`:\n\n```yml\nplugins:\n - search\n - table-reader\n```\n\n> If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set.\n\n## Usage\n\nIn your markdown files you can now use:\n\n```html\n{{ read_csv('path_to_table.csv') }}\n```\n\nWhere the path is relative to the location of your project's `mkdocs.yml` file (although you can [change that](https://timvink.github.io/mkdocs-table-reader-plugin/options) to be relative to your `docs/` directory).\n\n- There are [readers](https://timvink.github.io/mkdocs-table-reader-plugin/readers/) for `.csv`, `.fwf`, `.json`, `.xlsx`, `.yaml` and `.tsv` files. There is also the `read_raw()` reader that will allow you to insert tables (or other content) already in markdown format.\n\n## Documentation and how-to guides\n\nSee [timvink.github.io/mkdocs-table-reader-plugin/](https://timvink.github.io/mkdocs-table-reader-plugin/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MkDocs plugin to directly insert tables from files into markdown.",
"version": "2.2.1",
"project_urls": {
"Homepage": "https://github.com/timvink/mkdocs-table-reader-plugin"
},
"split_keywords": [
"mkdocs",
"plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b4eea664c85abd99d6108007a57cf9e3f39300fcf352d1b7e51c89fa3e35c680",
"md5": "6183f70089021a82aca210a6045699f6",
"sha256": "35d7ccadcee70f8415f2a9c73f260074512585ce8f6b81267cd537effac260d6"
},
"downloads": -1,
"filename": "mkdocs_table_reader_plugin-2.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6183f70089021a82aca210a6045699f6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9488,
"upload_time": "2024-05-07T09:21:01",
"upload_time_iso_8601": "2024-05-07T09:21:01.999312Z",
"url": "https://files.pythonhosted.org/packages/b4/ee/a664c85abd99d6108007a57cf9e3f39300fcf352d1b7e51c89fa3e35c680/mkdocs_table_reader_plugin-2.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2e7fd88dc4313c0abc3d9168d6018c830737bf08693ce45f87ab20a7ee799cb9",
"md5": "d250729b74e5dfd457256f76e961922b",
"sha256": "8205b422bb37368e3e8c0bf5932e08400442946a1b07fdc0bb11df09c409291b"
},
"downloads": -1,
"filename": "mkdocs_table_reader_plugin-2.2.1.tar.gz",
"has_sig": false,
"md5_digest": "d250729b74e5dfd457256f76e961922b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11197,
"upload_time": "2024-05-07T09:21:03",
"upload_time_iso_8601": "2024-05-07T09:21:03.435030Z",
"url": "https://files.pythonhosted.org/packages/2e/7f/d88dc4313c0abc3d9168d6018c830737bf08693ce45f87ab20a7ee799cb9/mkdocs_table_reader_plugin-2.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-07 09:21:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "timvink",
"github_project": "mkdocs-table-reader-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mkdocs-table-reader-plugin"
}
JSON
