SpeedDrain
GFM Spec · Auto-Delimiter Detection · Instant Export

CSV to Markdown Table

Convert Excel spreadsheets, TSV dumps, and CSV exports into beautifully aligned GitHub Flavored Markdown tables for READMEs, documentation, and PR comments.

|

Per-Column Alignment Overrides

Product Name
Category
Price ($)
In Stock
Rating
| Product Name                                   | Category    | Price ($) | In Stock | Rating |
| :--------------------------------------------- | :---------- | :-------- | :------- | :----- |
| MacBook Pro 16, Laptops, 2499.00, Yes, 4.9     |             |           |          |        |
| Sony WH-1000XM5                                | Audio       | 399.99    | Yes      | 4.8    |
| Dell UltraSharp 32, Monitors, 1099.50, No, 4.7 |             |           |          |        |
| Logitech MX Master 3S                          | Accessories | 99.99     | Yes      | 4.9    |
| Keychron Q1 Pro                                | Keyboards   | 199.00    | Yes      | 4.6    |

GitHub Flavored Markdown (GFM) Table Syntax

How Alignment Indicators Work in GFM

Markdown tables specify text alignment through the colon (:) placement on the header separator line:

  • Left-aligned (:--- or ---): Standard default for text strings, descriptions, and categories.
  • Center-aligned (:---:): Ideal for status badges, IDs, boolean flags (Yes/No), and icon indicators.
  • Right-aligned (---:): Standard typographic convention for numeric data, monetary currencies, and percentage metrics so decimal points line up vertically.

Quoted Delimiters & Edge Cases in CSV

Real-world CSV exports from Excel and Google Sheets contain edge cases that simple regex split functions break on:

  • Commas inside Quoted Cells: A value like "San Francisco, CA" must not be split into two separate columns.
  • Escaped Double Quotes: Double quotes inside a quoted cell are represented as "" (e.g. "Monitor 32"" 4K").
  • Ragged Rows: If some data rows contain fewer columns than the header, our parser automatically pads missing cells to prevent broken table layouts.