{"id":13502225,"url":"https://github.com/mplewis/csvtomd","last_synced_at":"2025-10-21T04:02:01.233Z","repository":{"id":62422821,"uuid":"21261722","full_name":"mplewis/csvtomd","owner":"mplewis","description":"📝📊 Convert your CSV files into Markdown tables.","archived":false,"fork":false,"pushed_at":"2020-04-27T07:38:21.000Z","size":41,"stargazers_count":659,"open_issues_count":6,"forks_count":88,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-01-07T22:05:15.046Z","etag":null,"topics":["csv-files","markdown","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mplewis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-06-27T02:36:05.000Z","updated_at":"2025-01-07T10:20:23.000Z","dependencies_parsed_at":"2022-11-01T17:33:45.347Z","dependency_job_id":null,"html_url":"https://github.com/mplewis/csvtomd","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mplewis%2Fcsvtomd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mplewis%2Fcsvtomd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mplewis%2Fcsvtomd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mplewis%2Fcsvtomd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mplewis","download_url":"https://codeload.github.com/mplewis/csvtomd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233976397,"owners_count":18760044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv-files","markdown","python"],"created_at":"2024-07-31T22:02:06.653Z","updated_at":"2025-09-23T12:32:38.461Z","avatar_url":"https://github.com/mplewis.png","language":"Python","readme":"# csvtomd: markdown tables made easy\n\n# [» Now online: csvtomd.com »](https://csvtomd.com)\n\n**The Python project is discontinued**\n\nThanks for all your contributions! At this time I'm not continuing development on the Python version of this tool.\n\nI'm moving work to the following JS projects:\n\n* [csvtomd lib](https://github.com/mplewis/csvtomd-lib)\n* [csvtomd web](https://github.com/mplewis/csvtomd-web)\n\nI'm happy to point to your projects if you decide to take over development on the Python version or create a CLI for the JS version! Just let me know.\n\n-----\n\n![Excel —\u003e Markdown](http://mplewis.com/files/csvtomd.png?)\n\n[![CircleCI](https://circleci.com/gh/mplewis/csvtomd.svg?style=svg)](https://circleci.com/gh/mplewis/csvtomd)\n\nConvert your CSV files into Markdown tables.\n\n[Tables Generator](http://www.tablesgenerator.com/markdown_tables) is a fantastic web tool for converting tabular data into all sorts of table layouts. I like how it lets me import CSV files, but I need the ability to convert many CSV files in batch for a docset on which I'm working.\n\nI built `csvtomd` to convert one or more CSV files into nicely-padded Markdown tables. Now you can build your tables in Excel and convert them for use in GitHub Markdown files without having to construct them by hand.\n\n# Installation\n\nThis is a Python 3 script, so use `pip3` to install:\n\n```\npip3 install csvtomd\n```\n\nAfter this, run `csvtomd --help` from your terminal to verify it's installed properly.\n\n# Usage\n\n`csvtomd MY_SPREADSHEET.csv` generates a Markdown table from `MY_SPREADSHEET.csv`.\n\n`csvtomd SHEET1.csv SHEET2.csv SHEET3.csv` generates three Markdown tables from the input files and displays them alongside the input filename.\n\n`csvtomd` or `csvtomd -` generates a Markdown table from standard input. You can type CSV data or pipe a file in.\n\n## Example Input\n\nFile: `thrones.csv`\n\n```\nFirst Name,Last Name,Location,Allegiance\nMance,Rayder,North of the Wall,Wildlings\nMargaery,Tyrell,The Reach,House Tyrell\nDanerys,Targaryen,Meereen,House Targaryen\nTyrion,Lannister,King's Landing,House Lannister\n```\n\n## Example Markdown Table\n\nCommand: `csvtomd thrones.csv`\n\nFirst Name  |  Last Name  |  Location           |  Allegiance\n------------|-------------|---------------------|-----------------\nMance       |  Rayder     |  North of the Wall  |  Wildlings\nMargaery    |  Tyrell     |  The Reach          |  House Tyrell\nDanerys     |  Targaryen  |  Meereen            |  House Targaryen\nTyrion      |  Lannister  |  King's Landing     |  House Lannister\n\n## Example Raw Output\n\nCommand: `csvtomd thrones.csv`\n\n```\nFirst Name  |  Last Name  |  Location           |  Allegiance\n------------|-------------|---------------------|-----------------\nMance       |  Rayder     |  North of the Wall  |  Wildlings\nMargaery    |  Tyrell     |  The Reach          |  House Tyrell\nDanerys     |  Targaryen  |  Meereen            |  House Targaryen\nTyrion      |  Lannister  |  King's Landing     |  House Lannister\n```\n\nCommand: `csvtomd --padding 0 thrones.csv`\n\n```\nFirst Name|Last Name|Location         |Allegiance\n----------|---------|-----------------|---------------\nMance     |Rayder   |North of the Wall|Wildlings\nMargaery  |Tyrell   |The Reach        |House Tyrell\nDanerys   |Targaryen|Meereen          |House Targaryen\nTyrion    |Lannister|King's Landing   |House Lannister\n```\n\n## Requirements\n\nPython 3.\n\nTested with Python 3.4.1 on Mac OS X 10.9.3.\n\nDoesn't require any external packages, so it should be platform-agnostic.\n\n## Help\n\nCommand: `csvtomd --help`\n\n```\nusage: csvtomd.py [-h] [-n] [-p PADDING] [-d DELIMITER] csv_file [csv_file ...]\n\nRead one or more CSV files and output their contents in the form of Markdown\ntables.\n\npositional arguments:\n  csv_file              One or more CSV files to be converted\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -n, --no-filenames    Don't display filenames when outputting multiple\n                        Markdown tables.\n  -p PADDING, --padding PADDING\n                        The number of spaces to add between table cells and\n                        column dividers. Default is 2 spaces.\n  -d DELIMITER, --delimiter DELIMITER\n                        CSV delimiter, expected values: ',', ';'. Default is ,\n```\n\n# Contributions\n\nBug reports, fixes, or features? Feel free to open an issue or pull request any time.\n\n## Testing\n\nI only accept pull requests for features with tests.\n\n```sh\n# Run tests in the project root\n$ py.test\n============================= test session starts ==============================\nplatform darwin -- Python 3.5.0, pytest-3.0.5, py-1.4.31, pluggy-0.4.0\nrootdir: /your/path/to/csvtomd, inifile:\ncollected 3 items\n\ntest/test_csvtomd.py ...\n\n=========================== 3 passed in 0.04 seconds ===========================\n```\n\n## Releasing\n\n```sh\n# Bump version number in setup.py and csvtomd.py\n# Delete old builds\nrm -rf dist\n# Build source and binary wheel distribution\npython setup_wrap.py sdist bdist_wheel\n# Upload to PyPI\npip install twine\ntwine upload dist/*\n```\n\n[Here's an actual guide to PyPI.](https://packaging.python.org/distributing/) [And another really good one.](https://hynek.me/articles/sharing-your-labor-of-love-pypi-quick-and-dirty/)\n\n# License\n\nCopyright (c) 2017 Matthew Lewis. Licensed under [the MIT License](http://opensource.org/licenses/MIT).\n","funding_links":[],"categories":["Python","Tools","Development"],"sub_categories":["Converters","VoIP"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmplewis%2Fcsvtomd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmplewis%2Fcsvtomd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmplewis%2Fcsvtomd/lists"}