HUGO
News Docs Themes Community GitHub

RenderString

Renders markup to HTML.

Syntax

PAGE.RenderString [OPTIONS] MARKUP

Returns

template.HTML
{{ $s := "An *emphasized* word" }}
{{ $s | .RenderString }} → An <em>emphasized</em> word

This method takes an optional map of options:

display
(string) Specify either inline or block. If inline, removes surrounding p tags from short snippets. Default is inline.
markup
(string) Specify a markup identifier for the provided markup. Default is the markup front matter value, falling back to the value derived from the page’s file extension.

Render with the default markup renderer:

{{ $s := "An *emphasized* word" }}
{{ $s | .RenderString }} → An <em>emphasized</em> word

{{ $opts := dict "display" "block" }}
{{ $s | .RenderString $opts }}<p>An <em>emphasized</em> word</p>

Render with Pandoc:

{{ $s := "H~2~O" }}

{{ $opts := dict "markup" "pandoc" }}
{{ $s | .RenderString $opts }} → H<sub>2</sub>O

{{ $opts := dict "display" "block" "markup" "pandoc" }}
{{ .RenderString $opts $s }}<p>H<sub>2</sub>O</p>