CSV to Markdown Table Converter

This sample shows what happens to IDs with leading zeros, vertical bars and values spanning more than one line. Try it in the tool above or download the example files below.

id,name,note
00127,Alice,"Research | QA"
00128,Bob,"Line 1
Line 2"
00129,陈,"A <script> tag"
00130,João,"Says ""hello"""

| id | name | note |
| :--- | :--- | :--- |
| 00127 | Alice | Research \| QA |
| 00128 | Bob | Line 1<br>Line 2 |
| 00129 | 陈 | A &lt;script&gt; tag |
| 00130 | João | Says "hello" |

The value Research | QA becomes Research \| QA so the pipe stays inside one cell. The line break in Bob's note becomes <br>, while text such as <script> is displayed as text.

Copying a table from Excel or Google Sheets usually creates text with tabs between cells and newlines between rows. Paste that selection in CSV Input and leave Column separator on Auto detect. You can then convert the pasted cells just as you would a CSV file.

If the copied range contains merged cells, formulas or unusual spreadsheet formatting, check the input before copying the result. The converter works with the copied text, not with the original workbook structure, and it does not accept .xlsx files directly. If you have a workbook instead of copied cells, first use our XLSX to CSV converter.

Product	Quantity
Notebook	12
Pencil	25

Start with the default settings for a typical CSV with column headings. Change only the options that match your source data or where you plan to paste the Markdown.

| Column 1 | Column 2 |
| :--- | :--- |
| 00127 | Alice |
| 00128 | Bob |

GitHub Markdown tables need a heading row followed by a row of at least three hyphens per column. A pipe inside a value must be escaped. Lists and separate paragraphs cannot be placed inside table cells. Markdown tables are best for reading data in documentation, not for preserving every detail of a CSV file. See GitHub's table formatting guide for the official syntax.

Use Markdown tables to show a concise list of products, configuration settings, test results or other structured data directly in a README.md, GitHub issue or documentation page. Unlike CSV, the table is readable when the Markdown file is displayed by a compatible renderer.

The preview above shows the table layout. Your GitHub README or Markdown editor may display alignment and line breaks differently, so check the result where you plan to publish it. You can confirm the final appearance in your destination editor. For reference, see the GitHub Flavored Markdown table specification.

The converter keeps values such as dates, IDs and amounts as text. It changes CSV formatting into Markdown table syntax, so the result is readable but is not an identical copy of your original CSV file.

Keep your original CSV file if you need to preserve its exact contents and formatting. This tool converts text, not Excel formulas, styles or merged cells. To inspect the original CSV values before converting, open the file in our CSV Viewer Online.

The visible preview shows at most 20 data rows and 12 columns to keep the page responsive. Copy and download contain the complete generated Markdown table within the limits above.

CSV is better for importing and processing structured data in spreadsheet software, databases and scripts. A Markdown table is better for showing a small dataset in a GitHub README, issue, documentation page or note. This converter turns CSV values into readable Markdown table syntax; it does not replace the original CSV file or preserve workbook formulas.

For datasets you want to search or inspect instead, use our CSV Viewer Online. To create a spreadsheet workbook from CSV, use the CSV to Excel Converter.

CSV reading, conversion, preview, copying and downloading happen on your device. Your source file, its name, cell values and resulting Markdown are not sent to our server or site analytics. General interaction events may be counted without including file contents.