Tables in Markdown: Create & Format Data

Presenting structured data or comparing features is often best accomplished using clear tables. GitHub-Flavored Markdown (GFM) supports native table rendering through pipes and hyphens, eliminating the need to write verbose HTML table tags. This guide explains how to format basic tables, align columns, apply inline formatting, and organize complex datasets.

How to Create a Basic Table in Markdown?

To create a basic table in Markdown, use vertical pipes | to divide columns and hyphens - on the second row to separate the headers from the data rows.

| Name    | Age | City      |
| ------- | --- | --------- |
| Alice   | 28  | Mumbai    |
| Bob     | 34  | Bangalore |
| Charlie | 22  | Delhi     |

This compiles into a clean grid:

The HTML equivalent generated by the parser:

<table>
  <thead>
    <tr><th>Name</th><th>Age</th><th>City</th></tr>
  </thead>
  <tbody>
    <tr><td>Alice</td><td>28</td><td>Mumbai</td></tr>
    <tr><td>Bob</td><td>34</td><td>Bangalore</td></tr>
    <tr><td>Charlie</td><td>22</td><td>Delhi</td></tr>
  </tbody>
</table>

How to Align Columns in Markdown Tables?

You can align the text in columns to the left, right, or center by adding colons : to the separator hyphens on the second row of the table.

Here is an alignment example in Markdown:

| Left Aligned | Centered | Right Aligned |
| :----------- | :------: | ------------: |
| Apple        |  Banana  |        Cherry |
| 100          |   200    |           300 |

And this renders in the browser as:

How to Apply Inline Formatting Inside Table Cells?

You can format cell text in a Markdown table just like standard paragraphs. Bold styling, italics, inline code, and links are all fully supported inside cells.

| Feature | Status | Documentation |
| :--- | :--- | :--- |
| **Bold styling** | _Italicized text_ | [Link](https://example.com) |
| `inline code` | ~~Deprecated~~ | [Visit Guide](https://meshworld.in/) |

This renders as:

How Do Column Widths Behave in Raw Markdown?

The column widths in your raw Markdown files do not need to match exactly. The parser automatically adjusts the columns to fit the longest line of text.

For example, these two tables produce identical output:

| Name | Age |
| --- | --- |
| Alice | 28 |

| Name    | Age |
| --------| ----|
| Alice   | 28  |

Summary Checklist

• Use pipes (\|) to establish columns.
• Use hyphens (-) on the second row to define headers.
• Use colons (:) on the separator row to align columns.
• Format cell text with bold, italics, or code elements.
• Avoid block elements like paragraphs and list items inside cells.

Frequently Asked Questions

Can I escape a pipe symbol inside a cell?

Yes! If you want to render a literal pipe symbol | inside a table cell without the parser treating it as a column separator, escape it with a backslash: \|.

Is the outer pipe character mandatory?

No. In most Markdown engines, the outer pipes (at the beginning and end of each line) are optional. However, including them makes the raw text look like a table and prevents formatting bugs.

How do I add vertical lines to borders?

Markdown does not support styling borders or grid lines directly. The final design is determined entirely by your CSS styling (for example, using Tailwind classes).

What to Read Next

• Images in Markdown - Complete Guide — Master adding screenshots, local assets, and linked illustrations.
• Code Blocks in Markdown - Syntax Highlighting Guide — Format multi-line code examples with clean language tags.