Hugo Markdown & Front Matter Syntax Test

This file is a comprehensive test of Hugo front matter fields, Goldmark Markdown features, shortcodes, and common content patterns. Use it to verify rendering, shortcodes, internal links, images, code highlighting, math, and more.

Paragraph with emphasis, strong, both and inline code().

Smart punctuation, dashes — and ellipses…

Emojis: :smile: :rocket:

Headings with attributes

Subsection

Anchor id, class and arbitrary attributes on headings (Goldmark attributes).

Links and Internal References

• External link: https://gohugo.io/
• Internal page reference (ref): https://rayt-bji.pages.dev/products/apex-pro-15/
• Relative link using relref: /blog/

Images and Figures

Inline image:

Figure shortcode (built-in):

Resource image referenced via page bundle (example):

Shortcodes

YouTube embed:

Code highlight shortcode:

package main

import "fmt"

func main() {
        fmt.Println("Hello Hugo highlight")
}

Fenced code block (Chroma syntax highlighting applies if enabled):

def greet(name):
        print(f"Hello, {name}")

Lists

Unordered list:

• Item one
• Item two
  • Nested item
  • Nested item 2
• Task done
• Task pending

Ordered list:

1. First
2. Second
   1. Second A
   2. Second B

Definition list (Goldmark extension)

Term 1

Definition of term 1.

Term 2

Definition for term 2, with multiple paragraphs.

Blockquotes and nested

This is a blockquote.

Nested blockquote.

Tables

Footnotes

A sentence with a footnote.¹

Math (KaTeX/MathJax if configured)

Inline math: $E = mc^2$

Block math:

$$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $$

Raw HTML

Attributes and IDs

Heading with attribute reference above: see section “Subsection” via id #custom-id.

Front Matter edge cases (demonstrated above)

• date, publishDate, expiryDate, lastmod
• draft flag
• authors list
• tags/categories/keywords
• slug, url, type, layout, weight
• menu entry
• outputs and params
• resources and cascade

HTML block with figure and caption (fallback if shortcode missing)

Testing content metadata usage

• summary: shown in lists — “Quick summary for list views.”
• description: used for meta description
• aliases: URL redirection test
• outputs: html, rss, json

End of Markdown syntax test. Use this file to validate Goldmark features, shortcodes, internal linking, resource handling, and front matter-driven behavior in Hugo.