RenderShortcodes

PAGE.RenderShortcodes

template.HTML

Use this method in shortcode templates to compose a page from multiple content files, while preserving a global context for footnotes and the table of contents.

For example:

{{ with site.GetPage (.Get 0) }}
  {{ .RenderShortcodes }}
{{ end }}

Then call the shortcode in your Markdown:

{{% include "/snippets/services.md" %}}
{{% include "/snippets/values.md" %}}
{{% include "/snippets/leadership.md" %}}

Each of the included Markdown files can contain calls to other shortcodes.

Shortcode notation

In the example above it’s important to understand the difference between the two delimiters used when calling a shortcode:

• {{< myshortcode >}} tells Hugo that the rendered shortcode does not need further processing. For example, the shortcode content is HTML.
• {{% myshortcode %}} tells Hugo that the rendered shortcode needs further processing. For example, the shortcode content is Markdown.

Use the latter for the “include” shortcode described above.

Further explanation

To understand what is returned by the RenderShortcodes method, consider this content file

+++
title = 'About'
date = 2023-10-07T12:28:33-07:00
+++

{{< ref "privacy" >}}

An *emphasized* word.

With this template code:

{{ $p := site.GetPage "/about" }}
{{ $p.RenderShortcodes }}

Hugo renders this:;

https://example.org/privacy/

An *emphasized* word.

Note that the shortcode within the content file was rendered, but the surrounding Markdown was preserved.