Tabs

Article last updated at November 20, 2026

Use tabs for mutually exclusive sections. For example, to separate instructions for different operating systems.

Warning

The construct works only if it is separated by blank lines — outside (before the opening and after the closing tag) and inside (between the tags and the content). Otherwise, it will not be processed and will remain plain text.

{% list tabs %}

- Tab 1 title

  Tab 1 text.

  * You can use lists.
  * And **other** markup.

- Tab 2 title

  Tab 2 text.

{% endlist %}

Result:

Tab 1 text.

  • You can use lists.
  • And other markup.

Tab 2 text.

Video generated with Diplodoc Screencaster.

Note

Tabs, accordions, radio buttons, and dropdowns share common properties described on the page Common parameters.

Previous