MD

Markdown Tables

Master the art of creating tables in Markdown. From basic syntax to advanced formatting techniques and alignment options.

Jump to Section

Basic Tables

Learn the fundamental syntax for creating tables in Markdown.

Simple Table

Markdown
| Name | Age | City |
| --- | --- | --- |
| John | 25 | New York |
| Jane | 30 | London |
| Bob | 35 | Paris |
Preview
NameAgeCity
John25New York
Jane30London
Bob35Paris

Use pipes (|) to separate columns and dashes (-) to create the header separator.

Table Without Outer Pipes

Markdown
Name | Age | City
--- | --- | ---
John | 25 | New York
Jane | 30 | London
Bob | 35 | Paris
Preview
NameAgeCity
John25New York
Jane30London
Bob35Paris

Outer pipes are optional, but including them makes tables more readable.

Minimal Table

Markdown
| A | B |
|---|---|
| 1 | 2 |
Preview
AB
12

This is the minimum structure needed for a table - header, separator, and at least one data row.

Tips & Best Practices

  • Tables must have a header row followed by a separator row
  • Each row must have the same number of columns
  • Spacing around pipes is optional but improves readability
  • Empty cells are allowed

Column Alignment

Control how content is aligned within table columns.

Left, Center, and Right Alignment

Markdown
| Left | Center | Right |
| :--- | :----: | ----: |
| This | This   | This  |
| text | text   | text  |
| is   | is     | is    |
| left | center | right |
Preview
LeftCenterRight
ThisThisThis
texttexttext
isisis
leftcenterright

Use colons (:) in the separator row to control alignment.

Mixed Content Alignment

Markdown
| Product | Price | Rating |
| :------ | ----: | :----: |
| MacBook | $1299 | ⭐⭐⭐⭐⭐ |
| iPhone  | $899  | ⭐⭐⭐⭐ |
| iPad    | $329  | ⭐⭐⭐⭐⭐ |
Preview
ProductPriceRating
MacBook$1299⭐⭐⭐⭐⭐
iPhone$899⭐⭐⭐⭐
iPad$329⭐⭐⭐⭐⭐

Right alignment is perfect for numbers, center for ratings or status.

Alignment Syntax Reference

Markdown
| Syntax | Alignment |
| :--- | :--- |
| `:---` | Left align |
| `:----:` | Center align |
| `----:` | Right align |
| `---` | Default (usually left) |
Preview
SyntaxAlignment
:---Left align
:----:Center align
----:Right align
---Default (usually left)

Remember: colon on left = left align, both sides = center, right side = right align.

Tips & Best Practices

  • Left alignment is the default in most Markdown processors
  • Right alignment is ideal for numeric data
  • Center alignment works well for status indicators
  • You can mix different alignments in the same table

Table Formatting

Add formatting to table content including bold, italic, code, and links.

Formatted Content

Markdown
| Feature | Status | Description |
| --- | :---: | --- |
| **Bold text** | ✅ | Text can be **bold** |
| *Italic text* | ✅ | Text can be *italic* |
| `Code` | ✅ | Inline `code` works |
| [Links](/) | ✅ | [External links](https://example.com) |
| ~~Strike~~ | ✅ | ~~Strikethrough~~ text |
Preview
FeatureStatusDescription
Bold text✅Text can be bold
Italic text✅Text can be italic
Code✅Inline code works
Links✅External links
Strike✅Strikethrough text

Most inline formatting works inside table cells.

Code and Commands

Markdown
| Command | Description | Example |
| --- | --- | --- |
| `git add` | Stage changes | `git add .` |
| `git commit` | Commit changes | `git commit -m "message"` |
| `git push` | Push to remote | `git push origin main` |
Preview
CommandDescriptionExample
git addStage changesgit add .
git commitCommit changesgit commit -m "message"
git pushPush to remotegit push origin main

Tables are perfect for documenting commands and APIs.

Mixed Media

Markdown
| Type | Example | Code |
| --- | --- | --- |
| Image | ![Logo](https://via.placeholder.com/50) | `![alt](url)` |
| Link | [Visit Site](https://example.com) | `[text](url)` |
| Code | `function()` | `\`code\`` |
Preview
TypeExampleCode
ImageLogo![alt](url)
LinkVisit Site[text](url)
Codefunction()\code``

You can include images, links, and code examples in tables.

Tips & Best Practices

  • Escape pipe characters with backslash: \|
  • Use HTML for complex formatting not supported in Markdown
  • Keep cell content concise for better readability
  • Consider using code blocks for multi-line code examples

Complex Tables

Handle more complex table scenarios and workarounds.

Tables with Line Breaks

Markdown
| Feature | Description |
| --- | --- |
| Multi-line | First line<br>Second line<br>Third line |
| Single line | Just one line |
Preview
FeatureDescription
Multi-lineFirst line<br>Second line<br>Third line
Single lineJust one line

Use HTML <br> tags for line breaks within table cells.

Long Content

Markdown
| Term | Definition |
| --- | --- |
| API | Application Programming Interface - a set of protocols and tools for building software applications |
| SDK | Software Development Kit - a collection of software development tools |
Preview
TermDefinition
APIApplication Programming Interface - a set of protocols and tools for building software applications
SDKSoftware Development Kit - a collection of software development tools

Long content will wrap automatically in most renderers.

Nested Lists Workaround

Markdown
| Task | Subtasks |
| --- | --- |
| Setup | <ul><li>Install dependencies</li><li>Configure environment</li></ul> |
| Development | <ul><li>Write code</li><li>Run tests</li></ul> |
Preview
TaskSubtasks
Setup<ul><li>Install dependencies</li><li>Configure environment</li></ul>
Development<ul><li>Write code</li><li>Run tests</li></ul>

Use HTML for nested lists inside tables.

Tips & Best Practices

  • Use HTML for advanced formatting not supported in Markdown
  • Consider breaking very wide tables into multiple smaller tables
  • For complex data, consider using dedicated table generators
  • Test table rendering across different platforms

Table Tools & Generators

Tools and techniques to make table creation easier.

CSV to Markdown

Markdown
# Original CSV:
# Name,Age,City
# John,25,New York
# Jane,30,London

| Name | Age | City |
| --- | --- | --- |
| John | 25 | New York |
| Jane | 30 | London |
Preview

Original CSV:

Name,Age,City

John,25,New York

Jane,30,London

NameAgeCity
John25New York
Jane30London

Many tools can convert CSV data to Markdown tables automatically.

Table Templates

Markdown
<!-- Feature Comparison -->
| Feature | Basic | Pro | Enterprise |
| --- | :---: | :---: | :---: |
| Users | 5 | 50 | Unlimited |
| Storage | 1GB | 100GB | 1TB |
| Support | Email | Priority | 24/7 |

<!-- API Documentation -->
| Endpoint | Method | Description |
| --- | :---: | --- |
| `/users` | GET | Get all users |
| `/users/:id` | GET | Get user by ID |
| `/users` | POST | Create new user |
Preview
<!-- Feature Comparison -->
FeatureBasicProEnterprise
Users550Unlimited
Storage1GB100GB1TB
SupportEmailPriority24/7
<!-- API Documentation -->
EndpointMethodDescription
/usersGETGet all users
/users/:idGETGet user by ID
/usersPOSTCreate new user

Pre-made templates can speed up common table creation tasks.

Tips & Best Practices

  • Online table generators can help with complex tables
  • Many text editors have Markdown table plugins
  • Spreadsheet applications can export to various formats
  • Keep a collection of table templates for common use cases
← Back to ReferenceTry in Editor →