---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/syntax/cuts-tabs.md
  - href: en/syntax/cuts-tabs.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-06-08T16:57:28.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/en/llms.txt

# Cuts and tabs

With YFM extensions, you can use interactive markup elements: cuts and tabs.

{% note info %}

The content of cuts and tabs can include any YFM markup.

{% endnote %}

<!-- source: en/_includes/blank-lines-note.md -->
{% note warning %}

A construction works only when it is separated by empty lines — outside (before the opening tag and after the closing one) and inside (between the tags and the content). Otherwise it won't render and will stay as plain text.

{% endnote %}
<!-- endsource: en/_includes/blank-lines-note.md -->

## Cuts {#cuts}

Use cuts to hide content. For example, additional information or long blocks of code.

```markdown
{% cut "Cut header" %}

Content displayed when clicked.

{% endcut %}
```

**Result**

{% cut "Cut header" %}

Content displayed when clicked.

{% endcut %}

## Tabs {#tabs}

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

To ensure tabs are displayed correctly, separate each tab list and the text within the tabs with empty lines:

* Use `{% list tabs %}` to start a tab list and `{% endlist %}` to end it.
* Place the text for one tab followed by the name of the next tab on a new line.

### Example of Grouped Tabs

```markdown
{% list tabs group=instructions %}

- Name of tab1

  First step of tab1.
  * You can use lists.
  * And **other** markup.

- Name of tab2

  First step of tab2.

{% endlist %}

Description...

{% list tabs group=instructions %}

- Name of tab1

  Second step of tab1.

- Name of tab2

  Second step of tab2.

{% endlist %}
```

**Result**


{% list tabs group=instructions %}

- Name of tab1

  First step of tab1.
  * You can use lists.
  * And **other** markup.

- Name of tab2

  First step of tab2.

{% endlist %}

Description...

{% list tabs group=instructions %}

- Name of tab1

  Second step of tab1.

- Name of tab2

  Second step of Tab 2.



{% endlist %}


{% note info %}

  The state of the tabs is saved upon page reload.

{% endnote %}