Frontmatter reference: every field this theme understands
A complete reference for the post and page frontmatter schema — required and optional fields, defaults, validation rules, and what each one actually does.
Reference
All posts
Page2of3
Typography & Markdown: every text element this theme renders
A kitchen-sink reference for headings, lists, blockquotes, tables, inline formatting, footnotes, definition lists, callouts and more — verified in both light and dark mode.
Reference
Code blocks & syntax highlighting with Expressive Code
Frame titles, copy buttons, line markers, diffs, terminal frames, word wrap and collapsible sections — every Expressive Code feature this theme exposes.
Authoring
LaTeX math with KaTeX, pre-rendered at build time
Inline and display math, matrices, integrals, sums, Maxwell's equations and more — all rendered at build time, with the KaTeX stylesheet loaded only on opt-in pages.
Authoring
MDX components & callouts: Markdown with superpowers
Use Astro components inside Markdown — the bundled <Callout>, JS expressions, slots, and a cookbook for building your own MDX-friendly components.
Tutorials
Bilingual content with first-class i18n
How English-at-root + French-under-/fr routing works, how to pair translated articles with translationKey, and how to add a third locale from scratch.
Tutorials
Search with Pagefind: instant, static, and fully offline
How the bundled Pagefind search works — modal vs full-page UX, indexing rules, keyboard shortcuts, locale filtering and customisation hooks.
Tutorials
Comments with Giscus, theme- and locale-synced
Wire up Giscus end-to-end — install the GitHub App, generate the IDs, set the env vars, sync theme + locale, and toggle comments per post.
Tutorials