Max Mustermann
tbsch is a standalone Hugo theme - fast, privacy-friendly and free of
external CDNs. This site shows every feature with a real, working example.
Great to have you here! This demo doubles as the theme’s documentation. Instead of a dry reference you’ll find living examples: each post introduces one functional area and shows in its source how it is done.
What the theme brings along #
- Solarflare design - a gradient running from orange through pink to violet, background heroes and a floating pill header.
- Automatic dark mode with a manual toggle and no flash on load.
- Token-based design system - spacing, typography, radii and motion as CSS custom properties.
- Images that take care of themselves - every Markdown image is converted to WebP, served responsively and zoomable via lightbox.
- Shortcodes for lead paragraphs, buttons, tabs, galleries, GitHub cards, Mermaid diagrams, KaTeX math and inline icons.
- GitHub-style admonitions (
> [!note],> [!warning], …), collapsible too. - Search (Pagefind, client-side), three feeds (RSS, Atom, JSON Feed) and an IndieWeb setup (microformats2, webmentions).
- Privacy: all fonts and libraries are hosted locally; external embeds go through the consent manager Klaro.
How to read this demo
Look at each post rendered and, in parallel, glance at its index.md.
The Markdown source is the actual manual.
Where to start #
| Topic | Post |
|---|---|
| Markdown & typography | Markdown basics |
| Callout boxes | Admonitions |
| Shortcodes | Shortcodes at a glance |
| Images & galleries | Images and galleries |
| Diagrams & math | Diagrams and math |
| Front matter & SEO | Front matter and SEO |
Working through them in order is best - or jump straight to whatever topic interests you right now.
