hugo/content/en/functions/transform/HTMLUnescape.md
Bjørn Erik Pedersen 9b0050e9aa Squashed 'docs/' content from commit 5c085a37b
git-subtree-dir: docs
git-subtree-split: 5c085a37b297bf12f59efeaae591418ec025c10d
2024-01-27 10:48:33 +01:00

30 lines
972 B
Markdown

---
title: transform.HTMLUnescape
description: Returns the given string, replacing each HTML entity with its corresponding character.
categories: []
keywords: []
action:
aliases: [htmlUnescape]
related:
- functions/transform/HTMLEscape
returnType: string
signatures: [transform.HTMLUnescape INPUT]
aliases: [/functions/htmlunescape]
---
The `transform.HTMLUnescape` function replaces [HTML entities] with their corresponding characters.
```go-html-template
{{ htmlUnescape "Lilo & Stitch" }} → Lilo & Stitch
{{ htmlUnescape "7 > 6" }} → 7 > 6
```
In most contexts Go's [html/template] package will escape special characters. To bypass this behavior, pass the unescaped string through the [`safeHTML`] function.
```go-html-template
{{ htmlUnescape "Lilo & Stitch" | safeHTML }}
```
[`safehtml`]: /functions/safe/html
[html entities]: https://developer.mozilla.org/en-us/docs/glossary/entity
[html/template]: https://pkg.go.dev/html/template