Tables

Requirements

You’ll need to upgrade Hugo to v0.134.0 or later, and enable the markup.goldmark.parser.attribute.block.

1[markup]
2  [markup.goldmark]
3    [markup.goldmark.parser]
4      [markup.goldmark.parser.attribute]
5        block = true

1markup:
2  goldmark:
3    parser:
4      attribute:
5        block: true

 1{
 2   "markup": {
 3      "goldmark": {
 4         "parser": {
 5            "attribute": {
 6               "block": true
 7            }
 8         }
 9      }
10   }
11}

Site Parameters

align

Vertical alignment.

Available options: top, middle, bottom.

bordered

Whether to enable borders globally.

border_style

Border style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

group_divider

Whether to add a thicker border, darker between table groups.

hover

Whether to enable a hover state on tables.

striped

Whether to add zebra-striping on table rows.

striped_columns

Whether to add zebra-striping on table columns.

style

Table style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

thead_style

Table header style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

Site Parameters Example

 1[params]
 2  [params.hb]
 3    [params.hb.tables]
 4      align = ''
 5      border_style = ''
 6      bordered = true
 7      group_divider = false
 8      hover = true
 9      striped = true
10      striped_columns = false
11      style = ''
12      thead_style = ''

 1params:
 2  hb:
 3    tables:
 4      align: ""
 5      border_style: ""
 6      bordered: true
 7      group_divider: false
 8      hover: true
 9      striped: true
10      striped_columns: false
11      style: ""
12      thead_style: ""

 1{
 2   "params": {
 3      "hb": {
 4         "tables": {
 5            "align": "",
 6            "border_style": "",
 7            "bordered": true,
 8            "group_divider": false,
 9            "hover": true,
10            "striped": true,
11            "striped_columns": false,
12            "style": "",
13            "thead_style": ""
14         }
15      }
16   }
17}

Table Attributes

_align

Vertical alignment.

Available options: top, middle, bottom.

_borderless

Whether to remove border.

_bordered

Whether to enable border.

_border_style

Border style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

_caption

Caption.

_group_divider

Whether to add a thicker border, darker between table groups.

_hover

Whether to enable a hover state on tables.

_striped

Whether to add zebra-striping on table rows.

_striped_columns

Whether to add zebra-striping on table columns.

_size

Table size.

Available options: sm.

_style

Table style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

_thead

Whether to show the header.

_thead_style

Table header style.

Available options: danger, dark, light, info, primary, secondary, success, warning.

Examples

Default Tables

The style depends on the default configurations.

1| Default Table |
2| --- |
3| Foo |
4| Bar |

Horizontal Alignments

1| Left | Center | Right |
2| :- | :-: | -: |
3| 1 | 2 | 3 |
4| 1 | 2 | 3 |
5| 1 | 2 | 3 |

Vertical Alignments

1| Heading 1 | Heading 2 |
2| --- | --- |
3| `top` | This here is some placeholder text, intended to take up quite a bit of vertical space, to demonstrate how the vertical alignment works in the preceding cells. |
4{_align=top}

1| Heading 1 | Heading 2 |
2| --- | --- |
3| `middle` | This here is some placeholder text, intended to take up quite a bit of vertical space, to demonstrate how the vertical alignment works in the preceding cells. |
4{_align=middle}

1| Heading 1 | Heading 2 |
2| --- | --- |
3| `bottom` | This here is some placeholder text, intended to take up quite a bit of vertical space, to demonstrate how the vertical alignment works in the preceding cells. |
4{_align=bottom}

Table with Captions

1| Name | Age | Role |
2| --- | :-: | :-: |
3| Foo | 35 | Leader |
4| Bar | 23 | Developer |
5{_caption="Members"}

Table Styles

1| Primary Table |
2| --- |
3| Foo |
4| Bar |
5{_style=primary}

1| Danger Table |
2| --- |
3| Foo |
4| Bar |
5{_style=danger}

1| Dark Table |
2| --- |
3| Foo |
4| Bar |
5{_style=dark}

Bordered Tables with Border Styles

1| Primary Bordered Table |
2| --- |
3| Foo |
4| Bar |
5{_border_style=primary}

1| Danger Bordered Table |
2| --- |
3| Foo |
4| Bar |
5{_border_style=danger}

Borderless Tables

1| Borderless Table |
2| --- |
3| Foo |
4| Bar |
5{_borderless=true}

Small Tables

1| Small Table |
2| --- |
3| Foo |
4| Bar |
5{_size=sm}

Table Header Styles

1| Primary Header |
2| --- |
3| Foo |
4| Bar |
5{_thead_style=primary}

1| Danger Header |
2| --- |
3| Foo |
4| Bar |
5{_thead_style=danger}

1| Dark Header |
2| --- |
3| Foo |
4| Bar |
5{_thead_style=dark}

Table Without Header

1| | | |
2|-|-|-|
3| 1 | 1 | 1 |
4| 2 | 2 | 2 |
5| 3 | 3 | 3 |
6| 4 | 4 | 4 |
7{_thead=false}