Creating nested fenced code blocks with Hugo

As part of writing Taking more control over your Cobra CLI documentation, I needed to include a fenced code block which had a fenced code block inside it.

Doing some searching around, it appears that it's possible to increment the number of backticks surrounding a code block to wrap it correctly.

I.e. the inner-most code block needs to have three backticks, and then the outer code block will have four backticks.

For instance:

````go-text-template
## {{ .Command.CommandPath }}

{{ if .Command.Deprecated -}}
> [!WARNING]
> Note that the <code>{{ .Command.CommandPath }}</code> command is deprecated:
>
> {{ .Command.Deprecated }}
{{ else -}}
```console
{{ .Command.Use }}
```
{{ end }}
````

(This hopefully will render OK, given it's a code block containing a code block containing a code block πŸ˜…)

Written by Jamie Tanna's profile image Jamie Tanna on .

Content for this article is shared under the terms of the Creative Commons Attribution Non Commercial Share Alike 4.0 International, and code is shared under the Apache License 2.0.

#blogumentation #hugo.

This blog post is 100% human-written, and has nothing derived from LLMs (be it code, editorial support or prose).

This post was filed under articles.

Interactions with this post

Interactions with this post

Below you can find the interactions that this page has had using WebMention.

Have you written a response to this post? Let me know the URL:

Do you not have a website set up with WebMention capabilities? You can use Comment Parade.