{"id":13910472,"url":"https://github.com/lzakharov/csv2md","last_synced_at":"2026-04-15T21:04:17.804Z","repository":{"id":41280907,"uuid":"120132241","full_name":"lzakharov/csv2md","owner":"lzakharov","description":"Command line tool for converting CSV files into Markdown tables.","archived":false,"fork":false,"pushed_at":"2024-11-05T18:13:06.000Z","size":38,"stargazers_count":124,"open_issues_count":1,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-30T15:54:36.239Z","etag":null,"topics":["cli","csv","csv2md","markdown","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/csv2md","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/lzakharov.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-03T21:42:22.000Z","updated_at":"2025-06-16T21:22:01.000Z","dependencies_parsed_at":"2022-08-10T01:43:30.506Z","dependency_job_id":"c92f820e-7961-4fe8-9181-cf398c13278d","html_url":"https://github.com/lzakharov/csv2md","commit_stats":{"total_commits":47,"total_committers":1,"mean_commits":47.0,"dds":0.0,"last_synced_commit":"897bb15ad039497ae2c8cc14115284a6d2746e60"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/lzakharov/csv2md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzakharov%2Fcsv2md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzakharov%2Fcsv2md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzakharov%2Fcsv2md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzakharov%2Fcsv2md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lzakharov","download_url":"https://codeload.github.com/lzakharov/csv2md/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzakharov%2Fcsv2md/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265733903,"owners_count":23819435,"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":["cli","csv","csv2md","markdown","python"],"created_at":"2024-08-07T00:01:27.221Z","updated_at":"2026-04-15T21:04:17.798Z","avatar_url":"https://github.com/lzakharov.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# csv2md\n\nCommand line tool for converting CSV files into Markdown tables.\n\n## Installation\n\ncsv2md can be installed from source:\n\n```commandline\n# type in project directory\npython setup.py install\n```\n\nOr with `pip` from PyPI:\n```commandline\npip install csv2md\n```\n\n### Requirements\n\n- Python 3.6 or later. See https://www.python.org/getit/\n\n## Usage\n\nGenerate Markdown table from CSV file:\n\n```commandline\ncsv2md table.csv\n```\n\nGenerate Markdown table from TSV file:\n\n```commandline\ncsv2md -d $'\\t' table.tsv\n```\n\nGenerate Markdown tables from list of CSV files:\n\n```commandline\ncsv2md table1.csv table2.csv table3.csv\n```\n\nGenerate Markdown table from standard input:\n\n```commandline\ncsv2md\n```\n\nYou can also use it right inside your code, for example:\n\n```python\nfrom csv2md.table import Table\n\nwith open(\"input.csv\") as f:\n    table = Table.parse_csv(f)\n\nprint(table.markdown())\n```\n\n### Examples\n\nInput file: `simple.csv`\n\n```\nyear,make,model,description,price\n1997,Ford,E350,\"ac, abs, moon\",3000.00\n1999,Chevy,\"Venture «Extended Edition»\",\"\",4900.00\n1996,Jeep,Grand Cherokee,\"MUST SELL! air, moon roof, loaded\",4799.00\n```\n\nOutput: `csv2md simple.csv`\n\n```\n| year | make  | model                      | description                       | price   |\n| ---- | ----- | -------------------------- | --------------------------------- | ------- |\n| 1997 | Ford  | E350                       | ac, abs, moon                     | 3000.00 |\n| 1999 | Chevy | Venture «Extended Edition» |                                   | 4900.00 |\n| 1996 | Jeep  | Grand Cherokee             | MUST SELL! air, moon roof, loaded | 4799.00 |\n```\n\nMarkdown table:\n\n| year | make  | model                      | description                       | price   |\n| ---- | ----- | -------------------------- | --------------------------------- | ------- |\n| 1997 | Ford  | E350                       | ac, abs, moon                     | 3000.00 |\n| 1999 | Chevy | Venture «Extended Edition» |                                   | 4900.00 |\n| 1996 | Jeep  | Grand Cherokee             | MUST SELL! air, moon roof, loaded | 4799.00 |\n\nYou can also specify delimiter, quotation characters and alignment (see [Help](https://github.com/lzakharov/csv2md#help)).\n\n## Help\n\nTo view help run `csv2md -h`:\n\n```commandline\nusage: csv2md [-h] [-d DELIMITER] [-q QUOTECHAR] [-C COLUMNS]\n              [-c [CENTER_ALIGNED_COLUMNS ...]]\n              [-r [RIGHT_ALIGNED_COLUMNS ...]] [-H]\n              [CSV_FILE ...]\n\nParse CSV files into Markdown tables.\n\npositional arguments:\n  CSV_FILE              One or more CSV files to parse\n\noptions:\n  -h, --help            show this help message and exit\n  -d DELIMITER, --delimiter DELIMITER\n                        delimiter character. Default is ','\n  -q QUOTECHAR, --quotechar QUOTECHAR\n                        quotation character. Default is '\"'\n  -C COLUMNS, --columns COLUMNS\n                        comma-separated list of column indices or ranges (from\n                        zero) to be processed, e.g. \"0,3-5,7\". Indices out of\n                        range will be ignored\n  -c [CENTER_ALIGNED_COLUMNS ...], --center-aligned-columns [CENTER_ALIGNED_COLUMNS ...]\n                        column numbers with center alignment (from zero)\n  -r [RIGHT_ALIGNED_COLUMNS ...], --right-aligned-columns [RIGHT_ALIGNED_COLUMNS ...]\n                        column numbers with right alignment (from zero)\n  -H, --no-header-row   specify that the input CSV file has no header row.\n                        Will create default headers in Excel format\n                        (a,b,c,...)\n```\n\n## Running Tests\n\nTo run the tests, enter:\n\n```commandline\npytest . -v\n```\n\n## Issue tracker\nPlease report any bugs and enhancement ideas using the csv2md issue tracker:\n\nhttps://github.com/lzakharov/csv2md/issues\n\nFeel free to also ask questions on the tracker.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzakharov%2Fcsv2md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flzakharov%2Fcsv2md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzakharov%2Fcsv2md/lists"}