CSV to Markdown Table
Turn CSV or tab separated data into a Markdown table with correct escaping, optional column alignment and padded columns so the raw source stays readable.
Last reviewed by the Radiatus Cloud team
Need this done properly for your business?
Radiatus delivers secure cloud, DevOps & compliance engineering.
Pasting a spreadsheet into a README
Markdown tables are the standard way to put tabular data into a README, a pull request description, a wiki page or a documentation site. They are also tedious to write by hand: every row needs pipes in the right places, the header separator has to have the same number of columns, and any pipe character inside a cell has to be escaped or the row silently breaks into the wrong number of columns.
What actually breaks a Markdown table
Three things. A literal pipe inside a cell, which must be written as an escaped backslash pipe. A newline inside a cell, which Markdown tables cannot represent at all and which has to become a break tag or be flattened. And a mismatch between the number of header cells and the number of separator dashes, which causes most renderers to give up and print the raw text. All three come from pasting real data rather than typing a table by hand.
Alignment and readability
The separator row controls alignment: a colon on the left aligns left, on the right aligns right, and on both sides centres. Numeric columns read far better right aligned, which is worth setting even though most people leave it default. Padding each column to a consistent width does not change how the table renders, but it makes the source diff readable, which matters when the table lives in a repository and gets reviewed.
Related tools
- User Agent Parser — Parse a User-Agent string into browser, engine, operating system and device. Explains why UA strings are unreliable and what to use instead.
- QR Code Generator — Generate QR codes for URLs, text, Wi-Fi and contact details. Adjustable error correction and size, produced entirely in your browser.
- Credit Card Validator — Validate a card number with the Luhn algorithm and identify the issuing network from its prefix. Runs locally, nothing is transmitted.
- Text Case Converter — Convert text between camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE, Title Case and sentence case. Runs entirely in your browser.
Frequently Asked Questions
Does it detect the delimiter automatically?
Yes. Comma, semicolon, tab and pipe are all detected from the first few lines, which covers data copied out of Excel, Google Sheets and most exports. You can override the choice if the guess is wrong.
How are pipe characters inside cells handled?
They are escaped with a backslash, which is the only form Markdown table renderers accept. Without escaping, a cell containing a pipe splits into two columns and the row breaks.
What happens to a cell containing a newline?
Markdown tables cannot hold a line break, so the newline is converted to a break tag, which renders correctly on GitHub and most static site generators, or flattened to a space if you prefer plain output.
Can I set column alignment?
Yes, per column. Right alignment is worth applying to numeric columns because it lines up the digits, which makes a table of figures far easier to scan.
Does padding change how it renders?
No. Extra spaces inside the cells are ignored by every renderer. Padding exists purely so the raw Markdown lines up in a text editor and produces a readable diff.
Privacy & Security
Everything runs in your browser; nothing is uploaded.
How to Use
Paste CSV or spreadsheet data and copy the Markdown table it produces.
Disclaimer: This tool is provided "as is" without warranty of any kind. Results are for educational and utility purposes.
Related Tools
User Agent Parser
UtilityParse a User-Agent string into browser, engine, operating system and device. Explains why UA strings are unreliable and what to use instead.
QR Code Generator
UtilityGenerate QR codes for URLs, text, Wi-Fi and contact details. Adjustable error correction and size, produced entirely in your browser.
Credit Card Validator
UtilityValidate a card number with the Luhn algorithm and identify the issuing network from its prefix. Runs locally, nothing is transmitted.