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
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 pageLists
Unordered Lists
- a
- b
- c
- d
Ordered Lists
- First
- Second
- Second First
- Mixing possible
- Second First
- 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:
Big multi-line block (numerated):
Continues numeration across page:
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
)
Star Example Image Title
Tables
heading (entered) | columns… |
---|---|
rows… (aligned) | content |
(can be indented)
Notes
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" >}}
Attribute | Value |
---|---|
author | Custom Author |
title | Demo Post [en-us] |
date | 2025-08-10 00:00:00 +0000 UTC |
lastmod | 2025-09-09 00:00:00 +0000 UTC |
slug | demo-custom-slug |
tags | [Demo] |
categories | [Demo] |
math | true |
asciinema | true |
... | … |