Demo Post [en-us]

Table of Contents

This is a sample blog post to test the Hugo Blog Awesome theme.

Headings (starting at level 2)

Heading Level 3

Heading Level 4

Heading Level 5

Text

Bold, Italic, Both, Crossed

Inline links

References: /ShallowDiveBlog/posts/demo-custom-slug/

You can link to:

  • sections of a page by literally using the unique heading text (e.g. #text)
  • other posts
    • using their custom slug (e.g. ../demo-custom-slug)

      slug: demo-custom-slug
      
    • using the filenames without the .md ending if no custom slug was specified (e.g. ../about)

      It’s also possible to get the URL of a post using {{< ref "posts/demo.md" >}} or {{< relref "posts/demo.md" >}} (this creates /ShallowDiveBlog/posts/demo-custom-slug/ or /ShallowDiveBlog/posts/demo-custom-slug/)

  • combine both (e.g. ../demo-custom-slug#text)

Read More

Read more on the demo page

Lists

Unordered Lists

  • a
  • b
    • c
  • d

Ordered Lists

  1. First
  2. Second
    1. Second First
      • Mixing possible
  3. Third

Quotes

Quote

But quotes can also be nested:

Nested

Quotes

are also possible

Code

Inline Code (no syntax highlighting)

echo "Code block"
# Supports Language Syntax Highlighting for most languages
# Math does not work in comments! ($1 + 1 = 2$)

It’s also possible to include code from a file in the static/code directory:

{{< include_code file="examples/hello_world.c" lang="c" >}}

(in this case for the file static/code/examples/hello_world.c)

#include <stdio.h>

int main(void) {
    printf("Hello, World!\n");
    return 0;
}

(Cannot be indented and does not support math rendering)

Math

If the following line is in the header KaTeX is added and enables the following blocks to be rendered to good locking equations:

math: true
  • Inline: $...$

  • Inline that also correctly escapes certain parts:

    {{< mathinline >}}$...${{< /mathinline >}}
    
  • Bigger (display-style): $$...$$

  • Multiline and bigger (also correctly escapes certain parts):

    {{< mathblock >}}
    $$
    ...
    $$
    {{< /mathblock >}}
    

Inline: $\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$

Big: $$\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$$

Big multi-line block:

$$ \begin{aligned} \sum_{k=1}^{n} k &= 1 + 2 + 3 + \cdots + n \\ &= \frac{n(n+1)}{2} \end{aligned} $$

Big multi-line block (numerated):

$$ \begin{align} f(x) &= x^2 + 2x + 1 \\ &= (x+1)^{\textcolor{red}2} \end{align} $$

Continues numeration across page:

$$ \begin{align} 1 + 1 = 2 \end{align} $$

Sometimes inline code is not correct formatted (like escape symbols \{) so you can use the shortcode mathline:

The set $V = {x_1, x_2, x_3}$ is the set of vertices. The set $E = \big{{x_1, x_2}, {x_1, x_3}\big}$ is the set of edges.

The set $V = \{x_1, x_2, x_3\}$ is the set of vertices. The set $E = \big\{\{x_1, x_2\}, \{x_1, x_3\}\big\}$ is the set of edges.

Images

Images placed into static/images/article or category/.../image.svg can be referenced:

  • As-is: ../../images/examples/stars.svg
  • As figure (subtitle, custom width/height: {{< figure src="../../images/examples/stars.svg" alt="Stars Example Image" title="Star Example Image Title" width=50%" >}}

(in this case for the file static/images/examples/stars.svg)

Stars Example Image

Stars Example Image

Star Example Image Title

Tables

heading (entered)columns…
rows… (aligned)content

(can be indented)

Notes

info icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License info icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License
This is a custom note!
bad icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License bad icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License
This is a custom note!
check icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License check icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License
This is a custom note!
warning icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License warning icon from Interface Icons - Solid Style by @roywj under Reshot Stock Icon Free License
This is a custom note!

Terminal Recordings (Asciinema)

Asciinema recordings stored in static/.../recording.cast can be referenced when enabled in the header:

asciinema: true
{{< asciinema file="code/examples/cowsay.cast" autoplay="true" loop="true" cols="60" rows="10" >}}

(in this case for the file static/code/examples/cowsay.cast)

Other

Page information

Get page information values using:

{{< param "author" >}}
AttributeValue
authorCustom Author
titleDemo Post [en-us]
date2025-08-10 00:00:00 +0000 UTC
lastmod2025-09-09 00:00:00 +0000 UTC
slugdemo-custom-slug
tags[Demo]
categories[Demo]
mathtrue
asciinematrue
...