Docs

Table

Last modified on June 10, 2025 • 5 min read • 899 words
Component  
Component  
Share via
Use the table shortcode to make your Markdown table responsive.
Overview   Arguments   Input Type   Remarks  

Overview  

Added in v0.8.0   

  Important

Bootstrap styling attributes require an explicit class argument as of release v0.22.0  . For example, use the following argument to accentuate a table with table-striped: class="table-striped".

Use the table shortcode to make your markdown table responsive. Responsive tables scroll horizontally to improve the layout on smaller screens. The following example illustrates how this works.

# Heading Heading Heading Heading Heading Heading Heading Heading Heading
1. cell cel cel cel cel cel cel cel cel
2. cell cel cel cel cel cel cel cel cel
3. cell cel cel cel cel cel cel cel cel
markdown 
{{< table >}}
| #  | Heading | Heading | Heading | Heading | Heading | Heading | Heading | Heading | Heading |
|----|---------|---------|---------|---------|---------|---------|---------|---------|---------|
| 1. | cell    | cel     | cel     | cel     | cel     | cel     | cel     | cel     | cel     |
| 2. | cell    | cel     | cel     | cel     | cel     | cel     | cel     | cel     | cel     |
| 3. | cell    | cel     | cel     | cel     | cel     | cel     | cel     | cel     | cel     |
{{< /table >}}

Arguments  

The shortcode supports the following arguments:

Name Type Required Default Comment
breakpoint select md Breakpoint of the element. Supported values: [none, xs, sm, md, lg, xl, xxl].
class string Class attributes of the element. It supports Bootstrap attributes to modify the styling of the element.
pagination-select string v1.23.0      Sets the per page options in the dropdown. Must be an array of integers or arrays in the format [label (string), value (int)]. Requires paginate = true. It is recommended to configure values that are a multitude of the pagination value.
paging bool v0.24.13      v1.23.0      Use paginate instead. Whether paging is enabled for the table.
pagingOptionPageSelect string v0.27.8      v1.23.0      Use pagination-select instead. Sets the per page options in the dropdown. Must be an array of integers or arrays in the format [label (string), value (int)]. Requires paginate = true.
pagingOptionPerPage int v0.27.8      v1.23.0      Use pagination instead. Sets the maximum number of rows to display on each page. Requires paging = true.
searchable bool v0.24.13      Toggle the ability to search the dataset.
sortable bool v0.24.13      Toggle the ability to sort the columns.
wrap bool Toggle the last column to wrap to a new row on smaller devices. This setting is not compatible with data tables.
Name Type Required Default
breakpoint select md
Breakpoint of the element. Supported values: [none, xs, sm, md, lg, xl, xxl].
class string
Class attributes of the element. It supports Bootstrap attributes to modify the styling of the element.
pagination-select string
v1.23.0      Sets the per page options in the dropdown. Must be an array of integers or arrays in the format [label (string), value (int)]. Requires paginate = true. It is recommended to configure values that are a multitude of the pagination value.
paging bool
v0.24.13      v1.23.0      Use paginate instead. Whether paging is enabled for the table.
pagingOptionPageSelect string
v0.27.8      v1.23.0      Use pagination-select instead. Sets the per page options in the dropdown. Must be an array of integers or arrays in the format [label (string), value (int)]. Requires paginate = true.
pagingOptionPerPage int
v0.27.8      v1.23.0      Use pagination instead. Sets the maximum number of rows to display on each page. Requires paging = true.
searchable bool
v0.24.13      Toggle the ability to search the dataset.
sortable bool
v0.24.13      Toggle the ability to sort the columns.
wrap bool
Toggle the last column to wrap to a new row on smaller devices. This setting is not compatible with data tables.

Input Type  

Name Type Required Default Comment
categories string, slice Categories to be used as filter. When set, only pages that belong to at least one of the provided categories are retrieved.
keywords string, slice Keywords to be used as filter. When set, only pages that match at least one of the provided keywords are retrieved.
nested bool If set, retrieves all pages below the section or current page recursively. By default, only first-order childs are retrieved.
reverse bool true Sets the sort order to descending.
section string Name of the content section.
sort select yes Key to sort by. Supported values: [date, title, weight].
tags string, slice Tags to be used as filter. When set, only pages that match at least one of the provided tags are retrieved.
Name Type Required Default
categories string, slice
Categories to be used as filter. When set, only pages that belong to at least one of the provided categories are retrieved.
keywords string, slice
Keywords to be used as filter. When set, only pages that match at least one of the provided keywords are retrieved.
nested bool
If set, retrieves all pages below the section or current page recursively. By default, only first-order childs are retrieved.
reverse bool true
Sets the sort order to descending.
section string
Name of the content section.
sort select yes
Key to sort by. Supported values: [date, title, weight].
tags string, slice
Tags to be used as filter. When set, only pages that match at least one of the provided tags are retrieved.

Remarks  

See the Tables Documentation in the content section for additional styling options.

On this page: