Home › Developer Tools › CSV to Markdown Table
CSV to Markdown Table
Paste CSV or upload a file and get a GitHub-flavored Markdown table instantly. The delimiter is detected automatically, columns are padded so the table lines up in plain text, and you can set each column to left, center or right alignment while watching the rendered preview.
Last updated:
Preview & column alignment
Advertisement
Advertisement
How to use the CSV to Markdown Table
- Paste your CSV into the input box, or upload or drop a .csv, .tsv or .txt file. Data copied from Excel or Google Sheets (tab-separated) works too.
- Check the delimiter. It is detected automatically; choose one manually if the preview looks wrong.
- Set the header and alignment. Use the first row as the header, and pick left, center or right for each column above the preview.
- Pick pretty or compact output. Pretty pads every column to the same width for readable source.
- Copy or download the Markdown and paste it into a README, GitHub issue, wiki or documentation page.
Markdown table syntax
A GitHub-flavored Markdown (GFM) table is a header row, a separator row and any number of body rows, with cells separated by pipes:
| Tool | Price | Rating |
| :------------- | ----: | :----: |
| Markdown Editor | 0 | 4.8 |
| Team Plan | 12.50 | 4.5 |The colons in the separator row set the alignment of each column. The spaces used to line columns up are optional: renderers ignore them, but they make the table far easier to read and review in plain text, in diffs and in pull requests.
| Separator | Alignment | Typical use |
|---|---|---|
--- | Default (usually left) | General text |
:--- | Left | Names, descriptions |
:---: | Center | Short status values, icons, ratings |
---: | Right | Numbers and prices, so decimals line up |
Limits of Markdown tables
- One line per row. Cells cannot contain real line breaks, so they are written as
<br>, which GitHub and most renderers display as a new line. - No merged cells. GFM has no colspan or rowspan. Repeat the value or leave cells empty.
- A header is required. Every GFM table needs a header row; when your CSV has none, generic "Column 1, Column 2" headers are added.
- Pipes must be escaped. A literal
|inside a cell is written as\|. Inline Markdown such as**bold**,`code`and links still works inside cells. - Big tables get unwieldy. Beyond a few dozen rows or very wide columns, consider linking to the CSV file instead; GitHub renders .csv files as searchable tables on its own.
Frequently asked questions
How do I make a Markdown table from CSV?
Paste the CSV here. Each CSV row becomes a table row with cells separated by | characters, and a separator row such as | --- | --- | is added under the header. Copy the result into any Markdown file that supports GitHub-flavored tables.
How does column alignment work in Markdown?
Alignment is set in the separator row under the header: :--- aligns left, :---: centers and ---: aligns right. A plain --- uses the renderer's default, which is usually left. Choose the alignment per column with the selectors above the preview.
What happens to commas, quotes and pipes inside cells?
Quoted CSV fields such as "Smith, John" stay in one cell and doubled quotes "" become a single quote. A | inside a cell would break the Markdown table, so it is escaped as \|. Line breaks inside a cell become <br> because Markdown table cells must be on one line.
Can I paste data from Excel or Google Sheets?
Yes. Copying cells from a spreadsheet puts tab-separated text on the clipboard. Paste it and the tab delimiter is detected automatically.
My CSV has no header row. What should I do?
Turn off Use first row as header. Markdown tables require a header, so the tool adds a generic one (Column 1, Column 2, ...) that you can edit afterwards.
Which sites render these tables?
GitHub, GitLab, Bitbucket, Gitea, Obsidian, Notion import, Docusaurus, MkDocs, Jekyll (kramdown), Hugo and most Markdown editors support pipe tables. Original Markdown.pl does not, so check your renderer if it shows raw pipes.
Are all the tools on FreeToolCabin tested for quality and accuracy?
Yes! Every tool on our site undergoes automated Q/A testing in real browser environments to ensure high precision, correct output, and zero errors. If you happen to spot a bug or have a suggestion, please contact us at [email protected] and our team will review it right away.
Related tools
Markdown Table GeneratorBuild Markdown tables in a grid or paste from Excel/CSV, with alignment and preview.CSV ViewerOpen a CSV or TSV file as a sortable, filterable table.CSV to JSONConvert CSV data to JSON with live preview.Markdown EditorWrite Markdown with a toolbar, live split preview, autosave and .md or HTML export.JSON to Excel ConverterTurn JSON into a styled .xlsx spreadsheet; nested arrays become their own linked sheets.JSON to CSVConvert JSON data to CSV for spreadsheets.Excel to CSVConvert XLSX spreadsheets to CSV.Excel Viewer (XLSX / XLS)Open XLSX, XLS and ODS spreadsheets in your browser without Excel.Line Ending ConverterConvert text and files between CRLF, LF and CR line endings.Markdown to HTMLConvert Markdown to clean HTML with a live editor.XML to JSONConvert XML to JSON with validation.Text Encoding ConverterDetect and convert text file encodings like UTF-8, UTF-16 and Latin-1.JSON ViewerExplore JSON as a collapsible tree, search keys and values and copy any node's path.TTF to WOFF2 ConverterConvert TTF and OTF fonts to WOFF2 or WOFF and get a ready @font-face CSS snippet.Chmod CalculatorConvert Linux file permissions between checkboxes, octal (755) and symbolic (rwxr-xr-x) notation.JSON to TypeScriptGenerate TypeScript interfaces or types from JSON, with nested types and optional fields.Morse Code TranslatorTranslate text to Morse code and back, then play it as sound or a blinking light, or save a WAV.HTML Table GeneratorBuild HTML tables in an editable grid with styles, header rows, CSV import and live preview.Hex to Text ConverterConvert hex to text and text to hex with UTF-8 support and space, 0x, \x or comma formats.JSON to XML ConverterConvert JSON to well-formed XML with attributes, arrays and pretty print.JSON to YAML ConverterConvert JSON to clean YAML as you type, with indent, quoting and sort options.YAML to JSON ConverterConvert YAML to pretty or minified JSON, with errors pinned to the exact line.HTML to Markdown ConverterTurn HTML or pasted rich text into clean Markdown with tables and live preview.JSON ValidatorCheck JSON with the exact line and column of each error, fix tips and one-click auto-fix.Image to Base64Convert images to Base64 data URIs, CSS backgrounds and HTML img tags in your browser.Base64 to ImagePaste a Base64 string or data URI to preview, identify and download the image.JSON CompareCompare two JSON documents and see every added, removed and changed path.Hex to DecimalConvert hex to decimal instantly with steps and signed mode.Decimal to HexConvert decimal to hex instantly with steps and signed mode.Binary to DecimalConvert binary to decimal instantly with steps and signed mode.Decimal to BinaryConvert decimal to binary instantly with steps and signed mode.Two's Complement CalculatorDecimal to two's complement binary and back for 4-64 bits, with invert-and-add-1 steps.XML to CSV ConverterConvert XML to CSV: detects repeating records, flattens nested data, pick your columns.CSV to XML ConverterConvert CSV to well-formed XML with custom root and row names, escaping and pretty print.TOML to JSON ConverterConvert TOML to JSON and JSON to TOML with a full v1.0 parser and clear error lines.JSON to Go StructTurn JSON into Go structs with inferred types, nested structs and json tags.JSON to Python ClassGenerate Python dataclasses, Pydantic models or TypedDicts with type hints from JSON.JSON to C# ClassConvert JSON to C# classes or records with System.Text.Json or Newtonsoft attributes.VCF to CSV ConverterConvert vCard (.vcf) contacts to CSV for Google or Outlook, or turn a CSV back into a VCF.Calendar Event (.ics) GeneratorCreate an .ics calendar invite with time zone, reminders and repeats + Google/Outlook links.CSV Column ExtractorPick, reorder and rename CSV columns, filter rows by value, and export a new CSV or JSON.CSV Diff CheckerCompare two CSV files by key column and see added, removed and changed rows cell by cell.CSV Duplicate Row RemoverRemove duplicate rows from a CSV by all or selected columns and download the cleaned file.CSV to HTML TableTurn CSV into clean HTML table code with a live preview, styling options and one-click copy.CSV TransposeSwap rows and columns of CSV, TSV or pasted spreadsheet data, with delimiter auto-detect.Date Format ConverterConvert any date to ISO 8601, RFC 2822, Unix time and custom strftime, moment or Java patterns.ENV to JSON ConverterConvert .env files to JSON or YAML and JSON back to .env, with quotes and multiline values.File to Base64Convert any file to a Base64 string or data URI with MIME detection, line wrap and download.HTML Table to CSVExtract any table from HTML or page source to CSV, TSV or JSON, with colspan and rowspan handled.IEEE 754 Floating Point ConverterConvert decimals to 32/64-bit IEEE 754 floats: toggle bits, see hex, exact value and rounding error.INI to JSON ConverterConvert INI and CFG files to JSON and JSON back to INI, with sections, arrays and types.IP Address ConverterConvert IPv4 to decimal, hex, binary, octal and back, with class and private/public check.ISBN Converter & ValidatorConvert ISBN-10 to ISBN-13 and back, validate check digits and hyphenate, one or in bulk.JSON Flatten / UnflattenFlatten nested JSON to dot or bracket path keys, or unflatten flat keys back to nested JSON.JSON to Dart ClassTurn JSON into Dart model classes with fromJson, toJson, null safety and nested classes.JSON to Java ClassTurn JSON into Java POJOs or records with Lombok, getters/setters and Jackson or Gson annotations.JSON to Kotlin Data ClassTurn JSON into Kotlin data classes for kotlinx.serialization, Gson, Moshi or Jackson.JSON to Markdown TableTurn a JSON array of objects into a GitHub Markdown table with column picker and alignment.JSON to PHP ArrayConvert JSON to PHP array code (short [] or array()) and PHP arrays back to JSON.JSON to Rust StructTurn JSON into Rust structs with serde derives, rename attributes, Option and Vec types.JSON to SQL ConverterConvert a JSON array of objects to CREATE TABLE and INSERT statements for MySQL, Postgres, SQLite.JSON to Swift StructTurn JSON into Swift Codable structs with CodingKeys, optionals and nested types.JSON to TOML ConverterConvert JSON to clean TOML with tables, arrays of tables, inline tables and dates.JSONL to JSON ConverterConvert JSON Lines / NDJSON to a JSON array and back, with line-level error reports.Properties to YAML ConverterConvert Java .properties to nested YAML (application.yml) and YAML back to properties.PX to EM ConverterConvert pixels to em using the parent font size, and em back to px, with conversion tables.Query String to JSONConvert URL query strings to JSON with nested brackets and arrays, and JSON back to a query string.REM to PX ConverterConvert CSS rem values to pixels for any root font size, with a quick 0.25–6rem table.