Skip to main content

Markdown & Congo Feature Showcase

·618 words·3 mins
This sample post is a practical tour of Markdown, Hugo, and the Congo theme. It combines placeholder text with formatting examples that can be copied into future posts.
Sample content: This article is intentionally feature-rich. Individual posts only need the elements that serve their subject.

Status: Published with Hugo

Paragraphs and inline formatting #

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Bold text draws attention, italic text adds emphasis, and bold italic text does both. Congo also styles strikethrough text, inline code, and ordinary links.

Escaped characters remain literal: *asterisks*, _underscores_, and # hash marks. Two trailing spaces create a hard line break.
This sentence begins on the next line without starting a new paragraph.

You can add useful inline HTML when Markdown alone is not enough: GIF, H2O, x2, highlighted text, and Ctrl+S.


Heading levels #

Page titles provide the first-level heading, so article sections normally begin at level two.

Level-three heading #

Level-four heading #

Level-five heading #
Level-six heading #

Blockquotes and citations #

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

A nested quotation can provide additional context.

Markdown such as bold text and code works inside a quote.

“Simplicity is the soul of efficiency.”
Austin Freeman1

Lists #

Unordered and nested #

  • Engineering
    • Mechanical systems
    • Electrical systems
    • Control systems
  • Technology
    • Linux
    • Networking
    • Local AI

Ordered #

  1. Write the content.
  2. Preview it with Hugo.
  3. Commit the source.
  4. Let GitHub Pages deploy it.

Task list #

  • Create a Hugo site
  • Configure the Congo theme
  • Add a custom domain
  • Replace this sample with the next great post

Definition list #

Hugo
A static site generator that turns content and templates into a deployable website.
Congo
A responsive Hugo theme with built-in components for rich technical and personal sites.
Markdown
A lightweight syntax for structured text.

Tables #

FeatureSyntaxTypical use
Bold**text**Emphasis
Link[label](URL)Navigation
Code`command`Technical terms
Task- [x] itemChecklists

Markdown works inside cells too: bold, italic, and code.

Code #

Inline commands such as hugo server sit naturally within a paragraph.

baseURL = "https://example.com/"
theme = "congo"
enableRobotsTXT = true

The next block uses Hugo syntax highlighting, line numbers, and highlighted lines:

1
2
3
4
5
6
7
8
package main

import "fmt"

func main() {
    message := "Hello from Hugo"
    fmt.Println(message)
}

Indented text can also form a code block:

hugo --gc --minify
git status --short

This is an ordinary link to the Hugo documentation, while this Hugo reference points to the site’s About page.

Visit the About page

Images and figures #

Standard Markdown image syntax is supported:

The tsmccallum.com profile image
A site image rendered through Markdown

Congo’s figure shortcode adds optimized presentation and a caption:

Profile image used on tsmccallum.com
A Congo figure using a root-relative static site image.

Congo components #

Alerts #

Alerts accept Markdown, links, and a configurable Congo icon.

Badges and icons #

Hugo Congo Markdown

Inline icons scale with surrounding text: GitHub, Mastodon, and email.

Mermaid diagram #

flowchart LR A[Write Markdown] --> B[Build with Hugo] B --> C[Deploy with GitHub Actions] C --> D[Serve with GitHub Pages]

Chart #

Mathematical notation #

Inline mathematics: \(E = mc^2\)

Block mathematics:

$$ \int_0^1 x^2\,dx = \frac{1}{3} $$

Collapsible content and raw HTML #

Open this disclosure widget

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante venenatis dapibus posuere velit aliquet.

Closing sample #

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

The horizontal rule below marks the end of the showcase.


End of sample post.


  1. Included as a demonstration of a footnote and citation, not as a claim about the quote’s provenance. ↩︎

Tim McCallum
Author
Tim McCallum
I write about engineering, technical leadership, and the practical application of emerging technology. This site is also a place for the projects and interests that keep me learning outside of work.