Convert CSV to a Markdown table
Convert a small CSV table when it needs to appear in a README or document. The first source row becomes the header, so prepare column names first if the original table has none.

How to use this tool
- Choose files in CSV format. Maximum files per batch: 1.
- Review Input encoding, Input delimiter, then start processing.
- Download the Markdown result and check its content and quality.
Choose the right settings
Select the source encoding and delimiter before creating the table. Pipes inside cells are escaped, and embedded line breaks are saved as <br> so they can be represented within a Markdown row.
- Supported input
- CSV
- Output
- Markdown
- Available settings
- Input encoding
- Input delimiter
Before you start
Establish the meaning of the input
Before converting or arranging data, identify what a row or value represents and keep a source copy. In tabular files, review headers, separators and text encoding; in structured files, inspect the required object or array shape. Identifiers, dates and amounts should not be interpreted solely from how a spreadsheet happens to display them.
Where the tool offers matching columns, type rules or output fields, choose them according to the destination’s requirements. Test a sample with a blank, a repeated value and a value containing punctuation. For labels, charts or personalized documents, check which column supplies each displayed value and whether the source units and wording are correct.
Define a few checks before processing: an identifier that must retain its spelling, a value with a known interpretation and an expected relationship between records. If the tool offers type conversion or matching rules, distinguish a source value from the program’s display of it. Test ambiguous dates or differently written keys before accepting a broad rule. Keep the chosen rules and destination requirements with the result; this makes a discrepancy traceable to input, interpretation or the requested transformation.
Verify values, structure and exceptions
Reopen or import the result using the destination’s settings. Compare headers, record counts and several values with the source, allowing for the operation you requested. A summary, split or duplicate-removal task can legitimately change the count; verify why it changed rather than expecting every transformation to keep identical rows.
Inspect any exception or validation report before continuing. If columns shift, characters are garbled or a key is not found, check delimiters, encoding and exact header spelling first. Encoding data does not encrypt it, and formatting a value does not confirm its meaning. For printed codes or labels, test the actual output before making the full set.
Example input and output
CSV headers/rows → Markdown tableExamples describe the workflow. Results depend on the source file and settings.
Check the saved result before using it
Paste the result into the document system you will use and inspect its headers and column count. Review values containing pipes or multiline descriptions for shifted cells or unexpected rendering.
If the result is different from what you expected
Merged cells and spreadsheet formatting do not carry into the Markdown table. Different renderers handle <br> differently, so review multiline cells in the destination as well as in the raw text.
Limits to keep in mind
- Markdown tables have limited support for multiline cells, styling and complex spreadsheet content.
Continue with a related tool
This guide explains the public browser tool. Keep a copy of the original and inspect the result before sharing it.