### Chapter 3

# Shortcodes

Hugo uses Markdown for its simple content format. However, there are a lot of things that Markdown doesn’t support well. You could use pure HTML to expand possibilities.

But this happens to be a bad idea. Everyone uses Markdown because it’s pure and simple to read even non-rendered. You should avoid HTML to keep it as simple as possible.

To avoid this limitations, Hugo created shortcodes. A shortcode is a simple snippet inside a page.

The Relearn theme provides multiple shortcodes on top of existing ones.

## Attachments

The Attachments shortcode displays a list of files attached to a page

## Button

Nice buttons on your page

## Children

List the child pages of a page

## Expand

Displays an expandable/collapsible section of text on your page

## Include

Displays content from other Markdown files

## Mermaid

Generation of diagram and flowchart from text in a similar manner as Markdown

## Notice

Disclaimers to help you structure your page

## Site param

Get value of site params variables in your page

## Tabbed views

Synchronize selection of content in different tabbed views