How to convert CSV to Markdown
- Drop your CSV file on the box above, or paste its content into the text box.
- Check the settings below the box; the defaults suit most files.
- Press Convert. You see a preview or a summary of the result.
- Download the .md file, or copy the text.
What is kept when you convert CSV to Markdown
- Output is a GitHub-flavoured Markdown table; numeric columns are right-aligned.
- Pipes in your data are escaped (\|) and line breaks inside cells become <br>, so the table never breaks apart.
- If the CSV has no header, columns are named column_1, column_2… because a Markdown table must have one.
Example
A short CSV input and the exact output this tool produces from it:
Input
name,city,score
"Smith, John",London,42
Anna,"New ""York""",7.5Output
| name | city | score |
| --- | --- | ---: |
| Smith, John | London | 42 |
| Anna | New "York" | 7.5 |About CSV and Markdown files
CSV (comma-separated values) is a table as plain text: one row per line, fields separated by commas, and fields that contain commas, quotes or line breaks wrapped in double quotes. It opens in Excel, Google Sheets, LibreOffice, any database tool.
Markdown is plain text with light formatting marks — # for headings, ** for bold, - for list items, backticks for code. README files, notes apps, GitHub and many documentation sites use it. It opens in any text editor, GitHub, Obsidian, Typora, VS Code.
Good to know
- If a spreadsheet showed all your data in one column, the file probably uses semicolons (common in Europe); choose the delimiter instead of relying on detection.
- GitHub, GitLab, Obsidian and most wikis render Markdown directly — paste the result rather than attaching the file.
Privacy and limits
The file is read and converted by this page in your browser; there is no upload and no account. Files up to 25 MB are accepted; a file of the wrong type or a damaged file is rejected with the reason.