Convert CSV to Markdown Table
Paste a CSV and get a tidy Markdown table with padded columns, ready for a README, wiki or issue. Pipes and line breaks are escaped for you, and nothing leaves your browser.
- No email required
- Stays on your device
- Padded, readable source
- Column alignment
- Runs on your device. Files are never uploaded.
- Free and unlimited. No sign-up, no watermark.
CSV to Markdown table in three steps
No account, no email, no waiting for an upload.
- STEP 01
Load your CSV
The separator is detected automatically, or you can set it.
- STEP 02
Choose alignment
Keep the default, or align columns left, center or right. Say whether the first row is a header.
- STEP 03
Copy the Markdown
Paste it into a README, wiki page, issue or chat that supports GitHub-style tables.
What CSV to Markdown table does, and what it doesn't
We'd rather tell you up front than surprise you after the download.
What you get
- Aligned source textColumns are padded so the table is easy to read and edit in plain text, not just when rendered.
- Alignment markersChoose left, center or right, written as :---, :---: or ---: in the divider row.
- Safe cell contentA pipe inside a cell is escaped as \|, and line breaks become <br>, so the table does not break.
- Header handlingUse the first row as the header, or turn that off and get placeholder names Column 1, Column 2 and so on.
- Unicode-aware widthsPadding counts characters rather than bytes, so accented text lines up.
Good to know
- Wide tables are hard to readMarkdown has no wrapping inside tables. A CSV with many columns or long cells makes long lines.
- No formatting inside cellsCell text is copied as it is. Add bold or links by hand.
- Renderer differencesGitHub-style tables are widely supported, but some Markdown flavors do not render them.
Your data never leave your device
The tool runs inside your browser instead of on our servers, so there is nothing to upload, store or delete afterwards.
Typical online tool upload
Your file travels over the internet, sits on someone else's computer for a while, and you wait for the upload and the download.
Mediaextractr no upload
The tool loads into your browser once, then works on your file locally. Nothing is sent, so nothing can leak.
When people use CSV to Markdown table
Document data in a README
Show sample rows or a list of options in a repo.
Paste a table into an issue
Share results in a bug report or pull request.
Write a wiki page
Convert a spreadsheet range into a table in minutes.
Prepare lecture notes
Add tables to Markdown-based notes and slides.
Mediaextractr vs typical upload tools
| MediaextractrPrivate | Typical upload tools | |
|---|---|---|
| Your file is uploaded | Never | Yes |
| Sign-up needed | No | Often, after a few files |
| Daily file limit | None | Often 1–2 free files |
| Watermark | Never | Sometimes |
| Wait for upload & download | No | Yes |
| Speed on very large files | Depends on your device | Depends on their servers |
How the table is written
The first row is written as the header, followed by a divider line of dashes, then one line per row. Each cell is padded with spaces to the width of the widest value in its column, with a minimum of three characters so the divider is valid.
The result looks like a table even before it is rendered, which makes reviews and diffs pleasant.
Tips: CSV to Markdown table
A few habits keep the table tidy:
- Remove columns you do not need first with the CSV column selector.
- Right-align number columns for easier comparison.
- Keep cells short. Move long text out of the table.
- Reverse the process with Markdown table to CSV.
- Need HTML instead? Use CSV to HTML table.
A short example: CSV to Markdown table
A CSV with the header name,qty and a row Bolt,12 becomes a three-line table: the header line, a divider of dashes, and the row, each cell padded to equal width. Choose right alignment for qty and the divider ends in a colon under that column, so renderers right-align the numbers.
Questions, answered
How do I convert CSV to a Markdown table?
Paste the CSV and copy the Markdown it produces.
Does converting my CSV upload it?
No. The Markdown is generated by script in this tab, so the data stays on your device.
How do I align columns?
Use the Column alignment setting to choose left, center or right.
What happens to a pipe character in a cell?
It is escaped as backslash plus pipe so it does not split the cell.
Will it work on GitHub?
Yes. The output uses the GitHub-flavored table syntax, which GitHub, GitLab and many other platforms render.
Can I make a Markdown table on my phone?
Yes. Paste the CSV in a current mobile browser and copy the table into your notes or Markdown app.