CSV to Markdown Table Converter
Turn CSV into a GitHub Flavored Markdown table with column alignment and proper pipe escaping.
Paste CSV and produce a Markdown table that renders correctly on GitHub, GitLab, and most Markdown engines. Pick the delimiter, mark the header row, and choose left, center, or right alignment for every column.
GitHub Flavored Markdown (the GFM spec) defines tables as a sequence of pipe-delimited rows where the second row is a divider made of dashes, with optional colons that set per column alignment. This tool reads CSV (with quote-aware parsing for fields that contain commas or embedded quotes), then writes a table that matches the GFM grammar.
Pipe characters inside cell values are escaped as backslash pipe, line breaks are collapsed to a single space, and tab characters are replaced with four spaces so multi-line CSV cells do not corrupt the table layout. Column widths are padded so the raw output stays readable in a code editor, which is helpful when the markdown will be committed to a repository.
If the first row is not a header, the tool generates Column 1, Column 2, and so on. Rows with fewer cells than the widest row are padded with empty cells so the table stays rectangular. Choose left, center, or right alignment to control how renderers display each column. The output is ready to paste into a README, an issue comment, or a documentation page.
- 1
Paste CSV
Drop CSV into the input area or upload a .csv file. Use the Load Example button to see a small sample table.
- 2
Configure parsing
Pick the delimiter (comma, semicolon, tab, or pipe), mark whether the first row is a header, and choose column alignment.
- 3
Copy the table
Press Convert to generate a GFM table with escaped pipes and padded columns. Copy the result to use anywhere Markdown is supported.
Add results to a pull request
Convert benchmark or test result CSVs into Markdown tables so reviewers can read them directly in the PR description.
Document API responses
Turn an example response that was exported as CSV into a clean table for API reference docs hosted on GitHub Pages.
Write release notes
Paste a CSV of issues or features and emit a properly aligned table for the release notes in CHANGELOG.md.
Share data in chat
Convert small datasets to Markdown for Slack or Discord channels that render Markdown messages.
Does my CSV leave the browser?
No. Parsing and conversion both happen in your browser tab. No network requests are made with the data, and nothing is stored on a server.
Will Markdown break if my cells contain pipes?
Pipe characters inside cell values are escaped as backslash pipe, which is the GFM convention. The table renders correctly even if every cell contains pipes.
What happens to line breaks inside a quoted CSV cell?
Markdown table cells cannot span lines, so any line break inside a cell is replaced with a single space. The data is preserved as a single readable cell.
How are quoted fields parsed?
The parser follows RFC 4180. Double quotes escape a single quote inside a quoted field, and delimiters inside quotes are ignored. Unquoted fields are taken verbatim.
Why are extra spaces added between cells?
Cells are padded so the raw Markdown is aligned in plain text editors. Renderers ignore the padding when displaying the table, so it has no visual effect.