CSV ⇄ Markdown Table Converter
Need to convert between CSV files and Markdown tables? Convert spreadsheet rows into clean GitHub-flavored Markdown tables, or extract tabular data from Markdown documents back into standard CSV. Runs 100% locally in your browser for complete privacy.
Select conversion mode:
Drop your CSV file here or click to browse
Processed locally — never uploaded
How the conversion works
Direction 1: Converting CSV to Markdown Table
- Select "CSV → Markdown": Choose this mode from the direction dropdown above.
- Add your CSV or TSV file: Drag and drop your file into the box. A live preview of the top rows appears immediately.
- Run the conversion: Click Convert. The tool reads your header row to define column names, adds a GFM separator row (
| --- | --- |), wraps each row with pipe delimiters, and safely escapes internal pipes (\|) and line breaks (<br>). - Download or copy: Download your clean
.mdfile or open it to copy the table directly into README files, documentation, or blog posts.
Direction 2: Converting Markdown Table to CSV
- Select "Markdown → CSV": Switch the direction dropdown to enable Markdown table extraction.
- Upload your Markdown file: Drop your
.md,.markdown, or.txtfile containing a pipe-delimited table. - Extract spreadsheet rows: Click Convert. The parser scans the file, detects the table boundary, isolates column headers, discards formatting separator rows (e.g.
|:---|---:|), unescapes pipe characters, and formats the output into standard comma-separated values. - Download your CSV: Save the resulting
.csvfile, ready for Excel, Google Sheets, Pandas, or database imports.
Why convert with our local tool?
- True Bidirectional Conversion: Seamlessly move from CSV to Markdown tables and back from Markdown documents to CSV spreadsheets without needing two separate utilities.
- GitHub Flavored Markdown (GFM) Standard: Generated tables comply with GFM specification, rendering seamlessly on GitHub, GitLab, Reddit, Obsidian, Notion, and static site generators.
- Intelligent Character Escaping: Safely escapes vertical pipe characters (
|) as\|and handles multi-line cells using<br>tags so rows never misalign. - Zero Server Uploads: All parsing and file writing runs entirely inside your browser's Web Worker. Your data is private, fast, and never shared.
Frequently asked questions
How do I convert a CSV file to a Markdown table?
Select "CSV → Markdown" from the direction menu, drop your CSV or TSV file, and click Convert. The tool parses column headers, inserts a standard GitHub Flavored Markdown (GFM) separator row (| --- | --- |), escapes reserved pipe characters, and outputs a formatted Markdown table (.md).
How do I convert a Markdown table back into a CSV file?
Select "Markdown → CSV", upload or drop your Markdown file (.md, .markdown, or .txt), and click Convert. The converter identifies the table structure, removes alignment markers, restores escaped pipe symbols and line breaks, and exports a standard RFC 4180 CSV spreadsheet.
What Markdown table syntax does this tool generate and accept?
The tool uses standard GitHub Flavored Markdown (GFM) pipe-table syntax. This format is natively supported by GitHub, GitLab, Reddit, Notion, Obsidian, Dev.to, Static Site Generators (Astro, Hugo, Jekyll), and standard Markdown parsers.
How are vertical pipes ("|") and multiline breaks in cells handled?
When converting CSV to Markdown, literal vertical pipes are escaped as "\|" to prevent column splitting, and newlines within cells are replaced with HTML "<br>" tags. When converting Markdown back to CSV, "\|" is decoded back to "|" and "<br>" tags are restored to genuine line breaks.
What file types can I upload for Markdown to CSV conversion?
You can upload .md, .markdown, or .txt files. You can even paste a Markdown table into a text file and drop it in. The parser extracts the tabular lines and ignores external text or headers.
Can I convert Markdown tables copied from GitHub READMEs or Notion?
Yes. Any pipe-delimited table copied from a README, documentation page, or Notion export can be saved as a .md or .txt file and converted directly into a clean CSV spreadsheet.
Is my data or file uploaded to any remote server?
No. All processing occurs 100% locally in your web browser via a client-side Web Worker. Your CSV and Markdown data never leaves your device, ensuring complete confidentiality.