Tables - Furo

Furo is under active development, and this documentation is not written yet!

# Tables

Tables can be the best way to organize sets of related pieces of data. Sphinx supports including tables inline, although the exact syntax and capabilities depend on the markup language used.

reStructuredText

    Grid table:

    +------------+------------+-----------+
    | Header 1   | Header 2   | Header 3  |
    +============+============+===========+
    | body row 1 | column 2   | column 3  |
    +------------+------------+-----------+
    | body row 2 | Cells may span columns.|
    +------------+------------+-----------+
    | body row 3 | Cells may  | - Cells   |
    +------------+ span rows. | - contain |
    | body row 4 |            | - blocks. |
    +------------+------------+-----------+

    Simple table:

    =====  =====  ======
       Inputs     Output
    ------------  ------
      A      B    A or B
    =====  =====  ======
    False  False  False
    True   False  True
    False  True   True
    True   True   True
    =====  =====  ======

Grid table:

Header 1 | Header 2 | Header 3
--- | --- | ---
body row 1 | column 2 | column 3
body row 2 | Cells may span columns.
body row 3 | Cells may span rows. | Cells contain blocks.
body row 4

Simple table:

Inputs | Output
--- | ---
A | B | A or B
False | False | False
True | False | True
False | True | True
True | True | True

Markdown (MyST)

    MyST supports tables like [GitHub Flavoured Markdown][1].

    | Header  | Another header |
    |---------|----------------|
    | field 1 | something      |
    | field 2 | something else |

    List tables are also a thing:

    ```{list-table}
    :header-rows: 1

    * - This is
      - the header
      - row
    * - First
      - row of
      - very important content
    * - Second
      - row of
      - very important content
    ```

    [1]: https://docs.github.com/en/github/writing-on-github/organizing-information-with-tables

MyST supports tables like GitHub Flavoured Markdown.

Header | Another header
--- | ---
field 1 | something
field 2 | something else

List tables are also a thing:

This is | the header | row
--- | --- | ---
First | row of | very important content
Second | row of | very important content