Tables

Create Markdown tables with column alignment and formatting, or import CSV data with the table shortcode in Hugo.

Basic Table

| Name    | Role       | Status |
| :---    | :---       | :---   |
| Alice   | Developer  | Active |
| Bob     | Designer   | Active |
| Charlie | PM         | Away   |

Name	Role	Status
Alice	Developer	Active
Bob	Designer	Active
Charlie	PM	Away

Column Alignment

Control alignment with colons in the separator row:

| Left-aligned | Center-aligned | Right-aligned |
| :---         | :---:          | ---:          |
| Left         | Center         | Right         |
| Text         | Text           | 123           |

Left-aligned	Center-aligned	Right-aligned
Left	Center	Right
Text	Text	123

Syntax	Alignment
`:---`	Left (default)
`:---:`	Center
`---:`	Right

Formatting in Tables

You can use inline formatting inside table cells:

| Feature | Syntax |
| :--- | :--- |
| **Bold** | `**Bold**` |
| `Code` | `` `Code` `` |
| [Link](/docs/) | `[Link](/docs/)` |
| ~~Strike~~ | `~~Strike~~` |

Feature	Syntax
Bold	`Bold`
`Code`	`Code`
Link	`[Link](/docs/)`
~~Strike~~	`~~Strike~~`

Multi-line Cells

Use <br> for line breaks within a cell:

| Step | Description |
| :--- | :--- |
| 1 | Install dependencies<br>`npm install` |
| 2 | Start the server<br>`npm run dev` |

CSV Table Shortcode

For large datasets, import tables from CSV files instead of writing Markdown by hand:

{{</* table path="results.csv" */>}}

Place the CSV file in the same folder as your content (page bundle) or reference a remote URL.

CSV Parameters

Parameter	Type	Default	Description
`path`	string	—	Required. Path to CSV file (relative to page) or remote URL
`delimiter`	string	`,`	Field delimiter character
`header`	string	`true`	If `"true"`, the first row renders as the table header
`caption`	string	—	Caption text below the table (supports Markdown and emoji)

CSV Examples

Tab-separated values:

{{</* table path="data.tsv" delimiter="\t" */>}}

With caption:

{{</* table path="results.csv" caption="**Table 1**: Experiment results 📊" */>}}

No header row:

{{</* table path="raw-data.csv" header="false" */>}}

Keep Markdown tables simple. If your table has more than 5-6 columns or needs complex formatting, use the CSV table shortcode or restructure the content as a list.