Convert CSV to Markdown Table Format
Markdown tables are the standard way to display tabular data in README files, GitHub pull requests, documentation sites like GitBook or Docusaurus, and note-taking apps like Obsidian and Notion. Writing them by hand is error-prone, especially with many columns. This converter generates valid GFM (GitHub Flavored Markdown) tables from any CSV input.
The tool supports column-level alignment using GFM's :---, :---:, and ---: separator syntax. You can override alignment for each column individually โ useful for right-aligning number columns while keeping text columns left-aligned.
Padding Modes
- Minimal (1 space) โ Adds one space either side of each cell value. Produces the most compact output, ideal for large tables or automated pipelines.
- Standard (2 spaces) โ Two spaces per side. Good balance between readability and compactness.
- Auto-align โ Pads every cell to match the widest value in its column. The resulting Markdown is human-readable in a monospace editor, and renders identically in all Markdown renderers.
Where Markdown Tables Are Used
GitHub, GitLab, and Bitbucket all render GFM tables in READMEs, wikis, and comments. Documentation frameworks like Docusaurus, MkDocs, and VitePress render them natively. Obsidian, Notion, Roam Research, and Bear all support Markdown tables for structured notes. This tool saves time any time you need to embed structured data in these environments.