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.

Gardener 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.

    Expand

    Displays an expandable/collapsible section of text on your page

    Mermaid

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

    Notice

    Disclaimers to help you structure your page

Report an issue

See a typo? Have a picture to recommend? Want to edit some words/phrases/sentences? You can simply submit a ticket to request we make the change. If you are github savvy, submit a pull request. Open Github Issue