# Adding a table to your post using markdown

**URL:** <https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544>\
**Category:** Using Discourse\
**Tags:** tutorial\
**Created:** [July 20, 2017, 7:58pm UTC](https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544 "2017-07-20T19:58:37Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)\
**Post date:** [July 20, 2017, 7:58pm UTC](https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544/1 "2017-07-20T19:58:37Z")

</div>

> 🔖 This guide explains how to add tables to your Discourse posts using Markdown.
> 
> 🙋 Required user level: All users

Adding tables to your posts can help present data in a structured and easy-to-read format. This guide will walk you through creating tables in Markdown on Discourse, covering table basics, alignment, and special features like adding emojis and images.

## Using the Table Builder

Discourse includes a built-in **Table Builder** that lets you create and edit tables using a spreadsheet-like interface — no Markdown knowledge required.

To insert a new table:

1. Open the composer
2. Click the **➕** button in the toolbar (the options menu)
3. Select **Insert table**
4. Use the spreadsheet editor to add your headers and data
5. Click **Build Table** to insert the generated Markdown table into your post

To edit an existing table in a post, click the **✏ Edit Table** button that appears above the table (visible to users with edit permissions). This opens the same spreadsheet editor pre-populated with the table’s data.

## Creating a simple table

Creating a table in Discourse using Markdown is straightforward. Here’s a step-by-step guide:

1. **Start by defining the header:**

- The first row of your table will contain the headers for each column.
- The second row separates the headers from the rest of the table.

Here is an example for a table with three columns:

```plaintext
| Col A | Col B | Col C |
|---|---|---|

```

This results in:

| Col A | Col B | Col C |
| --- | --- | --- |

1. **Add rows of data:**

- Each row starts and ends with the `|` character.
- Ensure the number of columns matches that of the header.

Example:

```plaintext
| Col A | Col B | Col C |
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 | :smile: |

```

This results in:

| Col A | Col B | Col C |
| --- | --- | --- |
| A1 | B1 | C1 |
| A2 | B2 | 😄 |

## Alignment

You can control the alignment of column contents with colons (`:`):

- Left-aligned: `|:---|`
- Center-aligned: `|:---:|`
- Right-aligned: `|---:|`

Example:

```plaintext
| Left | Center | Right |
|:---|:---:|---:|
| My content is on the left | I'm the center of the world | I like being on the right side |
| :waxing_gibbous_moon: | :full_moon: | :waning_gibbous_moon: |

```

This results in:

| Left | Center | Right |
| --- | --- | --- |
| My content is on the left | I’m the center of the world | I like being on the right side |
| 🌔 | 🌕 | 🌖 |

## Clickable links in Tables

Adding clickable links within tables can be useful for directing users to specific resources or external content.

To include a clickable link, use the standard Markdown link syntax within a table cell. The format is `[Link Text](URL)`.

Example:

```plaintext
| Column A | Column B | Column C |
|---|---|---|
| [Google](https://www.google.com) | Example Text | Another Link |

```

This results in:

| Column A | Column B | Column C |
| --- | --- | --- |
| [Google](https://www.google.com/) | Example Text | Another Link |

## Images in Tables

To use images in tables, you will need to use the escape character `\` before the pipe `|` in the image code after you upload it.

Example:

```plaintext
Image | Description
---|---
![A Chihuahua enjoying espresso \|411x500, 30%](upload://yHjzeeWrEA1oWYMT9ATBOPudbKk.jpeg) | A Chihuahua enjoying espresso in a cafe.

```

This results in:

| Image | Description |
| --- | --- |
| ![A Chihuahua enjoying espresso](https://global.discourse-cdn.com/meta/original/4X/f/3/2/f32f6511f376f1b0b41b288341a057c9df5b237c.jpeg) | A Chihuahua enjoying espresso in a cafe. |

## Clickable Images in Tables

To make an image clickable, you can nest the image Markdown syntax within the link Markdown syntax. Here’s the basic format:

```plaintext
[![alt text](image URL)](link URL)

```

The `alt text` is important for accessibility, as it describes the image if it does not load or is used by screen readers. Always use meaningful alt text.

Here’s how you can incorporate clickable images into a Markdown table:

```plaintext
| Image 1 | 
|---|
| [![Discourse Logo](upload://38VzhGhUKzAURX4FN7LfBEpX6r1.png)](https://meta.discourse.org/)

```

This results in:

| Image 1 |
| --- |
| [![Discourse Logo](https://global.discourse-cdn.com/meta/original/4X/1/6/0/1608e5fe8628c35c5fee23784ebed99d20d5e31b.png)](https://meta.discourse.org/) |

## Copy-pasting tables

You can copy tables from external documents or spreadsheets and paste them directly into posts, Discourse will automatically convert them into Markdown.

If you frequently create tables, you can also use tools like [TableConvert](https://tableconvert.com/?output=markdown) to convert tables from other formats (CSV, JSON, etc.) into Markdown.

> Last edited by @Lilly 2025-06-17T14:31:14Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544)._