·5 min read

Complete Guide to Markdown Table Syntax

Learn how to create professional tables in Markdown, including alignment, formatting, and best practices.

Basic Syntax

Markdown tables use pipe characters (|) to separate columns, with the second row using hyphens (-) as a separator.

| Name | Type | Required | | ----- | ------ | -------- | | id | string | yes | | title | string | no |

Column Alignment

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

| Left | Center | Right | |:------|:------:|-------:| | data | data | data |
  • :--- Left align (default)
  • :---: Center align
  • ---: Right align

Best Practices

  • Keep column widths consistent for readable source code
  • Use right alignment for numeric columns
  • Use left alignment for long text content
  • Avoid newlines inside cells
  • Use a Markdown formatter to align column widths

Try it now

Use our visual editor to create Markdown tables with ease.

Open Editor