About Markdown Tables

Markdown tables use pipes (|) and hyphens (-) to create structured data tables. They're widely supported in GitHub, GitLab, documentation sites, and markdown processors.

Markdown Table Syntax

Basic structure:

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

Column Alignment

Control column alignment using colons in the separator row:

• Left-aligned: |:---------| (default)
• Center-aligned: |:--------:|
• Right-aligned: |---------:|

Tips for Better Tables

• Keep cell content concise for better readability
• Use alignment to improve visual hierarchy
• Avoid complex formatting within cells
• Consider using HTML tables for advanced layouts

Where Markdown Tables Work

• GitHub/GitLab: README.md, issues, pull requests
• Documentation: MkDocs, Jekyll, Hugo, Docusaurus
• Forums: Stack Overflow, Reddit, Discord
• Note apps: Obsidian, Notion, Typora