Shortcodes

Use the inbuilt and custom Hugo shortcodes to extend beyond the default Markdown definition.

Introduction

The Hugo shortcodes are very useful for embedding tweets, Instagram posts, Vimeo videos, etc.

We have also added additional custom shortcodes for buttons, details, light/dark images, tables and raw HTML. See the shortcode templates in /themes/citadel/layouts/shortcodes.

Examples

code

Custom. Create codeblocks using local files.

flash

Custom. Create a standard alert flash with markdown content.

gist

Inbuilt. Include GitHub gist files in your markdown. Great for logs, small scripts etc.

img

Custom. Specify different images to match the system light and dark modes used by the Azure Citadel site theme.

raw

Custom. Embed raw HTML code when markdown doesn't go far enough. The example shows how to capture coloured ASCII output from terraform.

youtube

Inbuilt. Embed Youtube videos into your pages.