# Features

> A complete map of reader, author and maintainer capabilities.


The cards below provide a complete map of the theme's reader, author and
maintainer capabilities, with rendered examples and copyable Markdown for each
feature. The visual language and tokens come from the
[projectious.work brand design system](https://github.com/projectious-work/brand).

For an end-to-end workflow, continue with the
[content authoring guide](../guides/_index.md) and the
[maintenance guide](../maintenance.md).

## Shortcode syntax

A shortcode whose template reads inner content needs a closing tag. Use the
Markdown-rendering `%` delimiter for a body of prose, and the `<` delimiter when
nesting another shortcode so its HTML is not escaped. Unpaired shortcodes have no
closing tag and must not use an XML-style trailing slash.

Every shortcode shipped by the theme is documented in the feature cards below.


- [Versioned documentation](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/versioning/index.md) — Publish separate documentation builds and connect them with the version menu.
- [Tokens and public API](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/tokens/index.md) — Inspect the stable semantic CSS tokens and Tailwind namespaces generated from the theme source.
- [Terminal recordings](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/terminal-recordings/index.md) — Record and embed copyable terminal sessions with asciinema.
- [Tailwind and design tokens](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/tailwind/index.md) — Use the theme's Tailwind integration and stable projectious.work design tokens.
- [Data-driven components](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/data-driven-components/index.md) — Compose badges, card collections and data tables from Hugo data.
- [Tags](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/tags/index.md) — Use Hugo taxonomies for related-content and release-note metadata.
- [Search](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/search/index.md) — How the generated search index, header search and command palette work.
- [Mathematics](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/mathematics/index.md) — Render inline and display mathematics with KaTeX.
- [Jupyter notebooks](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/jupyter-notebooks/index.md) — Convert and publish reproducible notebook output.
- [Internationalization](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/internationalization/index.md) — Configure translated content, language navigation, metadata and RTL layout.
- [Header and navigation](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/header-navigation/index.md) — Configure primary links, repository actions, search and header controls.
- [Editing and feedback](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/editing-feedback/index.md) — Connect pages to their source files and optionally collect useful reader votes.
- [Diagrams and Charts](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/diagrams/index.md) — Create responsive diagrams, data-driven charts and generated vector figures.
- [Typst Graphics and CeTZ](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/typst-graphics/index.md) — Render mathematical, technical and domain-specific Typst graphics as responsive SVG.
- [Code blocks](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/code-blocks/index.md) — Configure syntax highlighting, filenames, line numbers, highlighted lines and linkable anchors.
- [Buttons and badges](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/buttons-badges/index.md) — Add linked actions and compact status labels.
- [Accessibility](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/accessibility/index.md) — Keyboard behavior, reader preferences and author responsibilities.
- [Callouts](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/callouts/index.md) — Emphasize supporting, successful, cautionary or critical information.
- [Cards](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/cards/index.md) — Present related choices, pages or resources as responsive cards.
- [Collapsible details](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/collapsible-details/index.md) — Hide optional detail behind an accessible disclosure control.
- [File trees](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/file-trees/index.md) — Explain project structure with nested folders and files.
- [Icons](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/icons/index.md) — Use bundled fallback icons and the mounted Tabler icon library.
- [Images](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/images/index.md) — Publish responsive figures, captions, dark variants and lightboxes.
- [Links](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/links/index.md) — Create base-path-safe links within and between Hugo pages.
- [Steps](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/steps/index.md) — Present ordered procedures with Markdown or structured components.
- [Tabs](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/tabs/index.md) — Place equivalent alternatives in a keyboard-accessible tab set.
- [Terminal output](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/terminal-output/index.md) — Show static command sessions with adaptive terminal styling.
- [Terminology](https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/terminology/index.md) — Keep recurring definitions consistent through a shared glossary.