See: - [Discussion on Hugo discourse][1] - [Markdown][2], [Hugo output][3] Hugo will automatically render this in Markdown: ```` ```md {{</* figure src="/images/org-mode-unicorn-logo.png" title="Org Mode + Hugo Rock!" */>}} ``` ```` As this in HTML: ```md {{< figure src="/images/org-mode-unicorn-logo.png" title="Org Mode + Hugo Rock!" >}} ``` [1]: https://discourse.gohugo.io/t/how-is-the-hugo-doc-site-showing-shortcodes-in-code-blocks/9074 [2]: https://gitlab.com/kaushalmodi/hugo-sandbox/raw/master/content/bugs/src-block-hugo-shortcodes-defined.md [3]: https://hugo-sandbox.netlify.com/bugs/src-block-hugo-shortcodes-defined/