Creating nested fenced code blocks with Hugo

Featured image for sharing metadata for article

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 , and last updated 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 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.