---
title: "Tables"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:rest-tables"
source: "Reference/ReStructuredText/Content/Tables.rst"
modified: "2026-09-14T09:38:54+00:00"
---

# Tables

There are several ways to create tables in reST.

It is recommended that you do not use large tables as they are not
responsive.

## Grid table

```rst
+----------+----------+
| Header 1 | Header 2 |
+==========+==========+
| 1        | one      |
+----------+----------+
| 2        | two      |
+----------+----------+
```

| Header 1 | Header 2 |
| --- | --- |
| 1 | one |
| 2 | two |

[http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables](http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables)

You can use this [table generator](https://www.tablesgenerator.com/text_tables) to
create a grid table.

## Simple table

```rst
========  ========
Header 1  Header 2
========  ========
1         one
2         two
========  ========
```

| Header 1 | Header 2 |
| --- | --- |
| 1 | one |
| 2 | two |

[http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables](http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables)

## CSV table

```rst
..  csv-table:: Numbers
    :header: "Header 1", "Header 2"
    :widths: 15, 15

    1, "one"
    2, "two"
```

| Header 1 | Header 2 |
| --- | --- |
| 1 | one |
| 2 | two |

[https://docutils.sourceforge.io/docs/ref/rst/directives.html#csv-table-1](https://docutils.sourceforge.io/docs/ref/rst/directives.html#csv-table-1)

## `t3-field-list-table` tables

`t3-field-list-table` is a custom directive, created by the t3SphinxThemeRtd
template. If you want your .rst file to be correctly rendered on other
platforms as well (for example GitHub), you should not use this.

```rst
..  t3-field-list-table::
    :header-rows: 1

    -   :Header1:   Header1
        :Header2:   Header2

    -   :Header1:   1
        :Header2:   one

    -   :Header1:   2
        :Header2:   two
```

| Header1 | Header2 |
| --- | --- |
| 1 | one |
| 2 | two |