Convert CSV or TSV to a GitHub Markdown table with aligned columns and escaped pipes
Runs in your browser. Nothing you type is sent anywhere. Checked against sources on 16 Oct 2026.A README or a GitHub issue shows tables written in Markdown, while data usually comes as CSV. Paste the CSV, or a TSV from a spreadsheet, and get a GitHub-flavoured Markdown table with the first row as the header. Quoted fields with commas and line breaks are read correctly, a pipe inside a cell is escaped as \| and a line break becomes <br>.
Paste or type your input.
Choose the options you need.
Press Ctrl+Enter, then copy or download.
Markdown tables are plain text: a header row, a delimiter row of dashes, then one line per row, with pipes between the cells. Writing one by hand is fine for three cells and tedious for thirty. This tool writes it from cells you already have.
What it writes. A GitHub-flavoured Markdown table, or CSV. With Line up columns on, every cell is padded so the pipes form straight columns in plain text, counting Chinese, Japanese and Korean characters and emoji as two columns wide. Off, the table is compact, which keeps diffs small.
Special characters. A pipe inside a cell would end it, so it is written as \|; a line break inside a CSV field becomes <br>. A pasted Markdown table is read the way the GitHub spec reads it: a row with too few cells is filled with empty ones and extra cells are dropped.
The rest of the article, and all 6 questions about Markdown Table Generator, are on the Markdown Table Generator page.
Write a header row with cells between pipes, then a delimiter row of at least three dashes per column, then one line per row: | Name | Price |, | --- | --- |, | Tea | 12 |. GitHub, GitLab and most editors render it. The generator writes all of it from pasted cells.
Select the cells in Excel or Google Sheets, press Ctrl+C, and paste into the generator. A spreadsheet copies cells separated by tabs, which the tool recognises; the first row becomes the header. Copy the Markdown and paste it into the README or issue.
Put colons in the delimiter row under the header: :--- aligns left, :---: centres and ---: aligns right. Without a colon the renderer decides, usually left. The generator sets the colons for you and can right-align every column that holds only numbers, such as prices or counts.
Yes. Paste the Markdown, choose CSV as the output, and copy or download it. The first table in the text is read the way GitHub reads it: escaped pipes become pipes again, short rows get empty cells, and fields with commas are quoted for Excel.
Rates and rules change; check the source before you rely on a figure.
Still stuck? Ask about Markdown Table Generator and anybody who knows can answer. No account needed.
Same job, other tools: TSV to JSON – Convert tab-separated values, such as a paste from Excel, into JSON.
On the related tools: Query String Parser – Split a URL query string into a table of decoded parameters.