CSV to Markdown

Why convert CSV to Markdown?

CSV (Comma-Separated Values) is text with a separator, an exchange format in use since the 1970s. In a note, a wiki or a prompt you want the same rows as a table you can read.

GitHub Flavored Markdown writes that table with vertical bars. A renderer shows it as a table when it supports tables. Otherwise the line stays text.

How does the conversion work?

Drop a CSV, TSV or TAB file, or paste the text. One file counts per run. Conversion starts when you click Convert to Markdown.

Common delimiters such as commas, semicolons and tabs are detected automatically. You do not pick one yourself. The first kept row becomes the header. If it is missing, add it first, or the first data values become the headings.

Empty cells stay empty. Completely empty rows are skipped. Shorter rows are padded with empty cells out to the widest row. A line break inside a cell becomes <br>, and that table row stays one line in the source. A vertical bar inside a cell is escaped so it does not cut the column. Long cells are not wrapped for you.

00123 can become 123, even when the field is quoted. The original text is not guaranteed to survive unchanged. Check IDs and numbers in the result.

While reading, a quoted field may contain the separator, a line break or a doubled quote. A name in quotes keeps its comma in the same cell. The output is Markdown.

The file is read as UTF-8. Windows-1252, ISO-8859-1 and UTF-16 are not detected. Save older files as UTF-8 first. The file picker allows up to 50 MB. Pasted text has no separate byte limit here.

Turn the YAML header on if you want it. It is on by default. You then see the Markdown source in a code block. Copy it or download a .md file.

What is the tool actually used for?

• Data list in wiki documentation. A CSV of plans, suppliers or inventory becomes a Markdown table in internal docs.
• Prompt with tabular data. The values sit in the prompt as a Markdown table.
• Hugo / Astro content tables. Statistics tables from exports land as Markdown blocks in blog posts.
• Markdown notes. The table sits in the note as text you can read the next time you open it.
• GitHub issue tables. Exports from tracking tools become tables that stay readable in the issue text.
• Report publishing. Convert raw CSV to Markdown first, then package the cleaned table with Markdown to PDF or Markdown to DOCX when the result needs to leave the wiki.

What stays: what doesn’t?

Still there: column order, cell text, empty cells, line breaks as <br>.

Always added: the first kept row as the header, then | --- |. That line is shown as a table when the renderer supports tables.

Can change: numeric text. 00123 can become 123, even in quotes. Leading zeros are not reliably kept.

Privacy: everything stays in your browser tab (Datenschutz)

CSV exports can be sensitive: mailing lists, customer lists, payroll figures. The file or pasted text is read locally in the browser and is not uploaded for this conversion. None of it is stored on someone else’s server for that conversion.

Which related converters exist?

This tool is part of the Markdown converter family:

• XLSX to Markdown, Excel including XLS and ODS, multi-sheet support.
• HTML to Markdown, file or paste mode.
• PDF to Markdown, including scanned PDFs via OCR.
• DOCX to Markdown, Word documents with heading structure and lists preserved.