# Escape shortcodes when processing Markdown using RenderString
**URL:** https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200
**Category:** support
**Created:** [July 2, 2025, 12:14am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200 "2025-07-02T00:14:47Z")
**Posts on this page:** 7
**Page:** 1
### Author:  [@dboulet](https://discourse.gohugo.io/u/dboulet)
#### Post date: [July 2, 2025, 12:14am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/1 "2025-07-02T00:14:47Z")
I’m having trouble escaping shortcodes when passing them through the [RenderString](https://gohugo.io/methods/page/renderstring/) function. I have some Markdown which contain shortcodes inside of code blocks and I want to prevent Hugo from processing the shortcodes.
Here’s a reduced test case: let’s say I put this into a shortcode template:
````auto
{{ print
"```go-html-template\n"
`{{< qr text="https://gohugo.io" />}}`
"\n```"
| .Page.RenderString
}}
````
Output:
This will output a code block with a QR code in it. This is not what I want.
The [conventional solution](https://discourse.gohugo.io/t/shortcode-syntax-example-within-a-code-block-is-being-executed/35494) is to escape shortcodes using something like `{{}}` but that’s not working in this case.
````auto
{{ print
"```go-html-template\n"
`{{}}`
"\n```"
| .Page.RenderString
}}
````
Output:
This outputs a code block which contains `{{}}`. The escape characters are left intact.
How do I escape shortcodes inside Markdown when using RenderString?
---
### Author:  [@jmooring](https://discourse.gohugo.io/u/jmooring)
#### Post date: [July 2, 2025, 5:10am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/2 "2025-07-02T05:10:57Z")
See [https://github.com/gohugoio/hugo/issues/10058](https://github.com/gohugoio/hugo/issues/10058).
Can you call your shortcode using the `{{% %}}` notation instead?
````plaintext
{{% sc %}}
Some **other** text.
```go-html-template {style=friendly}
{{}}
```
Some **other** text.
{{% /sc %}}
````
layouts/\_shortcodes/sc.html
```plaintext
{{ .Inner }}
```
rendered:
---
### Author:  [@dboulet](https://discourse.gohugo.io/u/dboulet)
#### Post date: [July 2, 2025, 3:15pm UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/3 "2025-07-02T15:15:31Z")
Thanks for the suggestion, @jmooring.
In my case, the Markdown content is being imported from an external source and my shortcode doesn’t use `.Inner`.
I would have expected the `RenderString` function and the content renderer to treat escaped shortcodes in the exact same manner but that doesn’t seem to be the case.
---
### Author:  [@jmooring](https://discourse.gohugo.io/u/jmooring)
#### Post date: [July 2, 2025, 6:21pm UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/4 "2025-07-02T18:21:34Z")
You might consider substitution.
```plaintext
{{ $s := `
Some **other** text.
~~~go-html-template
{{< qr text="https://gohugo.io" />}}
~~~
Some **other** text.
`
}}
{{ $s | strings.ReplaceRE "{{<" "@@@" | .Page.RenderString | strings.ReplaceRE "@@@" "{{<" | safeHTML }}
```
where “@@@” is any string that is unlikely to appear anywhere. You only need to replace one of the delimiters.
The only reason I’m using `~~~` is to make this example work where the input is multiline. Your input can use triple backticks.
And the only reason I’m using `strings.ReplaceRE` instead of `strings.Replace` is that I can pipe—the argument order of `strings.Replace` isn’t great.
---
### Author:  [@dboulet](https://discourse.gohugo.io/u/dboulet)
#### Post date: [July 3, 2025, 4:09am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/5 "2025-07-03T04:09:02Z")
Thanks again, @jmooring, I appreciate the help.
One work-around I found was to replace the triple backticks with the `{{< highlight >}}` shortcode. Escaping seems to work reliably when the code is inside that shortcode.
Something like this works:
```auto
{{ print
"{{< highlight go-html-template >}}\n"
`{{}}`
"\n{{< /highlight >}}"
| .Page.RenderString
}}
```
---
### Author:  [@jmooring](https://discourse.gohugo.io/u/jmooring)
#### Post date: [July 3, 2025, 4:12am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/6 "2025-07-03T04:12:23Z")
Perhaps I misunderstood. If what you’re receiving is always a code example, why not use the `transform.Highlight` template function directly?
---
### Author:  [@dboulet](https://discourse.gohugo.io/u/dboulet)
#### Post date: [July 3, 2025, 4:26am UTC](https://discourse.gohugo.io/t/escape-shortcodes-when-processing-markdown-using-renderstring/55200/7 "2025-07-03T04:26:05Z")
The examples that I gave above were simplified for clarity. The actual strings being rendered in my custom shortcode contain more than just code. They often also include things like paragraphs and headings written in Markdown, interspersed with code samples.