# Welcome to the tbsch theme

> An overview of the tbsch theme: what it can do, how this demo is structured and where to start.

_Source: https://theme.docs.tbsch.de/post/2026-02-23-welcome/ · As of: 2026-02-23_


<div class="tb-lead"><strong>tbsch</strong> is a standalone <em>Hugo</em> theme - fast, privacy-friendly and free of
external CDNs. This site shows every feature with a real, working example.</div>


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*.

> [!tip] 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](/post/2026-01-12-markdown-basics-typography/) |
| Callout boxes | [Admonitions](/post/2026-01-19-admonitions-callout-boxes/) |
| Shortcodes | [Shortcodes at a glance](/post/2026-01-26-shortcodes/) |
| Images & galleries | [Images and galleries](/post/2026-02-02-images-and-galleries/) |
| Diagrams & math | [Diagrams and math](/post/2026-02-09-diagrams-and-math/) |
| Front matter & SEO | [Front matter and SEO](/post/2026-02-16-front-matter-and-seo/) |

Working through them in order is best - or jump straight to whatever topic
interests you right now.