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.
Understanding the GFM table format — pipes, dashes and alignment markers.
| Name | Score | Grade | |:------|------:|:-----:| | Alice | 95 | A | | Bob | 82 | B | | Carol | 78 | C |
The separator row controls how each column renders.
Default — colon on left only. Best for text, names and descriptions.
Colons on both sides. Best for status, flags and short codes.
Colon on right only. CSVShift auto-selects this for numeric columns.
Three steps from flat CSV to formatted Markdown.
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.
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.
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.
For scripting and documentation generation workflows.
Common documentation and developer workflows.
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 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.
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.
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.
Other free converters on CSVShift you might need.
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.
| 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.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').