About the CSV to Markdown Table
Markdown tables are fiddly to type: every row needs the same number of pipes and the separator row has to line up. This converter builds the table from CSV, pads each column to its widest value so the raw Markdown is aligned, and escapes any pipe characters inside cells so they do not break the layout. Line breaks inside a cell are replaced with spaces, since GFM tables are single-line per row.
The output works in GitHub, GitLab, Bitbucket, Obsidian, Notion imports, Docusaurus, MkDocs, and any renderer that supports GFM tables. The header row is required by the format; if your CSV has none, untick the header option and column1, column2 headers are added.
For a rendered check, paste the result into the Markdown to HTML tool.
How to use
- Paste or upload the CSV.
- Copy the Markdown table.
- Paste it into your README, issue or wiki page.
Common questions
- Can I set column alignment?
- The separator row uses plain dashes (default alignment). Add a colon to the left or right of the dashes for a column to align it.
- Why is the raw table so wide?
- Columns are padded to their widest cell so the source aligns. Renderers ignore the padding.
- What about very large tables?
- Markdown tables render fine at a few hundred rows; beyond that, link to a CSV instead.