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.

Hugo-theme-learn provides multiple shortcodes on top of existing ones.


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


    Nice buttons on your page.


    List the child pages of a page


    Displays an expandable/collapsible section of text on your page


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


    Disclaimers to help you structure your page

    Open Link in New Tab

    How to open a link in a new tab.

    Raw HTML

    Display HTML content on a page.

    Site param

    Get value of site params variables in your page.