Shortcodes - Nimbus

Note boxes

type can be info (default), warning, success, or error.

1
2
3
{{< note type="tip" title="Pro tip" >}}
Your content here.
{{< /note >}}

Pro tip

type can also be passed positionally, but not combined with title= in the same call — Hugo rejects mixing positional and named arguments.

Terminal

1
2
3
{{< terminal command="bash" user="dev" host="prod-01" path="~/app" >}}
kubectl get pods
{{< /terminal >}}

bash

dev@prod-01:~/app$

kubectl get pods NAME READY STATUS RESTARTS AGE api-7d8f9c6b5d-x2k9p 1/1 Running 0 3m

Badges

1
2
{{< badge "kubernetes" "Kubernetes v1.28" >}}
{{< badge type="terraform" label="Terraform v1.5" url="https://terraform.io" >}}

Kubernetes v1.28 Docker Terraform v1.5 AWS

Code tabs

1
2
3
4
5
6
7
8
{{< code-tabs tabs="bash,PowerShell" >}}
​```bash
kubectl get pods
​```
​```powershell
kubectl.exe get pods
​```
{{< /code-tabs >}}

1
kubectl get pods

1
kubectl.exe get pods

Config reference tables

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{{< config-table >}}
- name: replicas
  type: integer
  default: "3"
  required: false
  description: Number of pod replicas to run.
- name: image
  type: string
  required: true
  description: Container image reference, including tag.
{{< /config-table >}}

Name	Type	Default	Description
replicas	integer	3	Number of pod replicas to run.
image*	string	none	Container image reference, including tag.

Diff blocks

1
2
3
4
5
6
7
8
9
{{< diff title="main.tf" >}}
​```diff
 resource "aws_instance" "web" {
-  instance_type = "t3.small"
+  instance_type = "t3.medium"
   ami           = "ami-0abcdef1234567890"
 }
​```
{{< /diff >}}

main.tf

1
2
3
4
5
 resource "aws_instance" "web" {
-  instance_type = "t3.small"
+  instance_type = "t3.medium"
   ami           = "ami-0abcdef1234567890"
 }

OpenAPI spec rendering

Drop a spec file into a page bundle and reference it — see the full example at API Reference.

1
{{< openapi src="openapi.yaml" >}}

Mermaid diagrams

1
2
3
4
{{< mermaid title="Request flow" >}}
graph LR
    A[Client] --> B[Service]
{{< /mermaid >}}

Request flow

graph LR A[Client] --> B[Service]