CSV to Markdown Table

What this tool does

CSV to Markdown Table converts spreadsheet data into a pipe table for README files, documentation, wikis and pull requests. It detects the delimiter, escapes pipe characters, can turn line breaks into <br>, aligns numeric columns to the right and pads columns so the raw Markdown is readable too, with a rendered preview.

Markdown tables are the standard way to show tabular data in README files, GitHub and GitLab issues, documentation sites and many wikis, but typing them by hand is tedious: every row needs pipes, the separator row needs dashes and colons for alignment, and one stray | in a cell breaks the layout.

This tool parses your data with Papa Parse, so quoted CSV fields with commas or line breaks are handled correctly, and tab-separated text copied straight from Excel, Numbers or Google Sheets is detected automatically. It writes a GitHub-flavoured Markdown table, escapes pipes and backslashes inside cells, optionally converts line breaks to <br> and pads every column to the same width, counting wide characters such as Chinese or emoji as two columns. Alignment can be set for all columns or chosen automatically so that numeric columns line up on the right. Nothing is uploaded.

How to use CSV to Markdown Table

1. Paste CSV, or select cells in a spreadsheet, copy them and paste into the input box.
2. Leave Delimiter on Detect, or choose comma, semicolon, tab or pipe.
3. Confirm whether the First row is a header; otherwise columns are named Column 1, Column 2 and so on.
4. Choose the Column alignment, and whether to pad columns, keep line breaks as <br> and trim spaces.
5. Check the rendered Preview, then copy the Markdown or download table.md.

Tips for better results

• Numbers right, text left makes price and quantity columns easy to compare, the way spreadsheets show them.
• Padding changes only the raw text, not how the table renders, so switch it off if you want the smallest possible output.
• Markdown tables cannot merge cells or contain lists; keep cells short and link to details instead.
• For a quick HTML table instead, convert the Markdown with Markdown to HTML Converter.

Common use cases

• Adding a feature comparison or configuration table to a README.
• Pasting benchmark results from a spreadsheet into a pull request.
• Writing documentation pages for static site generators such as Docusaurus or MkDocs.
• Posting a formatted table in a GitHub or GitLab issue.

Common mistakes to avoid

• Leaving out the header row; GitHub-flavoured Markdown requires one, so the tool generates column names if your data has none.
• Pasting cells that contain a pipe character without escaping; the converter writes \| for you.
• Expecting <br> to work everywhere; most GitHub-style renderers accept it, but some strict Markdown processors show it as text.