hugo/docs/content/en/functions/RenderString.md
Bjørn Erik Pedersen e625088ef5
Add render template hooks for links and images
This commit also

* revises the change detection for templates used by content files in server mode.
* Adds a Page.RenderString method

Fixes #6545
Fixes #4663
Closes #6043
2019-12-18 11:44:40 +01:00

1.2 KiB
Raw Blame History

title description godocref date categories menu keywords signature
.RenderString Renders markup to HTML. 2019-12-18
functions
docs
parent
functions
markdown
goldmark
render
.RenderString MARKUP

{{< new-in "0.62.0" >}}

.RenderString is a method on Page that renders some markup to HTML using the content renderer defined for that page (if not set in the options).

The method takes an optional map argument with these options:

display ("inline")
inline or block. If inline (default), surrounding ´

` on short snippets will be trimmed.
markup (defaults to the Page's markup)
See identifiers in List of content formats.

Some examples:

{{ $optBlock := dict "display" "block" }}
{{ $optOrg := dict "markup" "org" }}
{{ "**Bold Markdown**" | $p.RenderString }}
{{  "**Bold Block Markdown**" | $p.RenderString  $optBlock }}
{{  "/italic org mode/" | $p.RenderString  $optOrg }}:REND

Note that this method is more powerful than the similar markdownify function as it also supports Render Hooks and it has options to render other markup formats.