Free CSV to Markdown table — live preview — no upload

Convert CSV to Markdown
Table. GitHub-ready
in one click.

Free CSV to Markdown table converter. Auto-detects number columns and right-aligns them. Padded output for readable raw Markdown. Live rendered preview. Copy for GitHub, GitLab, Notion, Obsidian and any Markdown editor.

Your data never leaves your browser
GitHub Flavored Markdown
Live rendered preview
Copy to clipboard
Always free
Need the reverse? Markdown to CSV converter
CSV to Markdown Table  100% client-side
Drop your CSV file here
.csv, .txt or .tsv — or paste below
or paste CSV directly
Live rendered preview
 Markdown generated 

      

 
    

  

 
  
  
Markdown table syntax

  
Understanding the GFM table format — pipes, dashes and alignment markers.

 
  

    
Padded output — readable in raw form

    
| Name  | Score | Grade |
|:------|------:|:-----:|
| Alice |    95 |   A   |
| Bob   |    82 |   B   |
| Carol |    78 |   C   |

  

 
  
Column alignment markers

  
The separator row controls how each column renders.

  

    

      
Left :---

      
|:------|

      
Default — colon on left only. Best for text, names and descriptions.

    

    

      
Centre :---:

      
|:-----:|

      
Colons on both sides. Best for status, flags and short codes.

    

    

      
Right ---:

      
|------:|

      
Colon on right only. CSVShift auto-selects this for numeric columns.

    

  

 
  
  
How CSV to Markdown table conversion works

  
Three steps from flat CSV to formatted Markdown.

  

    

      
1

      

      
Detect column types

      
In auto-alignment mode, CSVShift samples the first 50 rows of each column. Columns where every non-empty value matches a numeric pattern (integer, decimal or scientific notation) are flagged as numeric and right-aligned in the output — matching standard table typography conventions.

    

    

      
2

      

      
Calculate column widths (padded mode)

      
In padded mode, the maximum character width across the header and all rows is calculated for each column. Every cell is padded to this width — left, right or centre depending on alignment — producing Markdown that is as readable in raw form as it is rendered.

    

    

      
3

      

      
Generate + preview

      
The Markdown table is built with | pipe separators, a separator row with alignment markers, and data rows. The live rendered preview shows exactly how GitHub, GitLab or Notion will display the table. Copy to clipboard and paste directly into your documentation.

    

  

 
  

 
  
  
CSV to Markdown table in Python

  
For scripting and documentation generation workflows.

 
  

    
pandas + tabulate (recommended)

    
import pandas as pd
 
df = pd.read_csv('data.csv')
 
# GitHub Flavored Markdown:
print(df.to_markdown(index=False))
 
# With right-aligned numbers:
print(df.to_markdown(index=False, colalign=('left','right','center')))

    
Requires: pip install pandas tabulate. df.to_markdown() uses tabulate internally and supports all GFM alignment options via colalign.

  

 
  

    
tabulate directly — more control

    
import csv
from tabulate import tabulate
 
with open('data.csv') as f:
    reader = csv.reader(f)
    headers = next(reader)
    rows = list(reader)
 
# GitHub Flavored Markdown:
print(tabulate(rows, headers=headers, tablefmt='github'))
 
# Pipe format (compatible with all Markdown parsers):
print(tabulate(rows, headers=headers, tablefmt='pipe',
               colalign=('left','right','center')))

    
Requires: pip install tabulate. tablefmt='github' produces GFM tables. tablefmt='pipe' is compatible with all Markdown parsers including Pandoc.

  

 
  

 
  
  
When do you need CSV to Markdown table?

  
Common documentation and developer workflows.

  

    

      
 GitHub and GitLab READMEs

      
Package comparisons, benchmark results, API endpoint lists and feature matrices are common README tables. Converting a CSV of data to Markdown and pasting into README.md produces a table that renders correctly on GitHub, GitLab and Bitbucket without any plugins.

    

    

      
 Documentation sites

      
Documentation built with MkDocs, Docusaurus, Sphinx or Hugo supports Markdown tables. Converting reference data, configuration options or API parameters from CSV to Markdown produces tables that render correctly in any Markdown-based doc site.

    

    

      
 Notion, Obsidian, Confluence

      
Knowledge base tools that support Markdown can import Markdown tables. Converting a CSV dataset to Markdown and pasting into Notion, Obsidian or Confluence produces a native table that can be sorted, filtered and edited within the tool.

    

    

      
 Technical writing and changelogs

      
Release notes, changelogs and technical specs often include tables of breaking changes, migration steps or API differences. CSV is the natural format for this data; Markdown table is the delivery format for documentation.

    

  

 
  

 
  
  
Related CSV tools

  
Other free converters on CSVShift you might need.

  
Markdown to CSV
Extract GitHub-flavoured Markdown tables into CSV.
CSV to Word
A styled table in a real .docx Word document.
RTF to CSV
Extract tables from Rich Text Format documents into CSV.
CSV to PDF
Print-ready PDF tables in portrait or landscape.
PDF to CSV
Extract tables from PDF statements and reports into CSV.
Word to CSV
Extract every table of a .docx file into CSV.
CSV to RTF
A styled RTF table that opens in Word, Pages and WordPad.
CSV to HTML
An HTML table in five styles with live preview.
HTML to CSV
Extract HTML tables, including merged cells, into CSV.
All document converters 

 
  
  
 
  

 
  
  

    

      
Markdown generated
in your browser. Copy-ready.

      
CSVShift generates the Markdown table entirely in JavaScript in your browser. Your CSV is never uploaded. The output follows GitHub Flavored Markdown (GFM) table syntax — compatible with GitHub, GitLab, Bitbucket, Notion, Obsidian, MkDocs, Docusaurus and any GFM-compatible parser.

      
The live rendered preview uses marked.js — the same Markdown parser behind many documentation platforms — so what you see in the preview is what you get when you paste into GitHub or your docs site.

    

    

      

        
Auto numeric alignment

        
Numeric columns detected and right-aligned automatically — matching standard table typography.

      

      

        
Padded raw Markdown

        
Padded mode produces Markdown that looks great in a code editor as well as rendered — like a professional docs project.

      

      

        
Live preview via marked.js

        
Preview renders using the same Markdown parser used by many documentation platforms.

      

      

        
Free, no conditions

        
No row limit, no watermark, no account. Funded by display advertising only.

      

    

  

 
  
  

    
Frequently asked questions

    
Common questions about converting CSV to Markdown tables.

 
    

      
How do I convert CSV to a Markdown table?

      
Upload your CSV or paste it into CSVShift, choose your alignment preference, and click Generate. Copy the Markdown to your clipboard and paste it into your README.md, documentation file or any Markdown editor.

    

 
    

      
How do I insert a table in a GitHub README?

      
GitHub READMEs support GitHub Flavored Markdown tables. Use | to separate columns and --- for the separator row. Convert your CSV here, copy the output, and paste it directly into your README.md. No plugins needed — GitHub renders it automatically.

    

 
    

      
How do I convert CSV to Markdown in Python?

      
Simplest: import pandas as pd; print(pd.read_csv('f.csv').to_markdown(index=False)). Requires pip install pandas tabulate. For more control use tabulate directly: tabulate(rows, headers, tablefmt='github').

    

 
    

      
What is the difference between padded and compact Markdown output?

      
Padded output aligns all columns to the same width — the raw Markdown looks like a proper table in a text editor. Compact output uses minimal whitespace — the raw Markdown is harder to read but produces a smaller file. Both render identically in GitHub and any GFM parser.

    

 
    

      
Is my data safe when converting CSV to Markdown online?

      
Yes. CSVShift generates the Markdown table entirely in your browser. Your CSV is never uploaded. Open the Network inspector during conversion — zero outbound data requests are made.