The content topic covers how the theme manages structured content — from Astro’s content collections and Zod-validated schemas through page routing, content sections, and the documentation system itself. This is also the starting point for editors who create and manage site copy.
Who this is for
- Implementors — setting up content collections, configuring schemas, and wiring content into page templates.
- Developers — extending collection schemas, adding new content types, or building custom content pipelines.
- AI agents — generating frontmatter-valid content files that pass the content ingestion linter.
- Editors — writing and managing pages, articles, and documentation using the content authoring workflow.
Key concepts
- Content collections — the theme uses Astro’s content collections (
pages,articles,docs,fragments) with Zod schemas that validate frontmatter at build time. Invalid content fails the build. - Frontmatter as contract — every content file’s frontmatter defines its metadata (title, description, dates, relationships). The content ingestion linter checks cross-references and required fields before build.
- Content sections and routes — pages are composed from content sections that map to layout regions. Routing follows a predictable file-to-URL convention.
- Documentation system — the docs collection powers the documentation site itself, with docId-based cross-referencing, topic grouping, and audience filtering.
In This Topic
- Content Authoring Guide — How to create, edit, preview, and publish content — a practical guide for editors working with pages and articles.
- Content Collections — Reference for the content collection system — collection types, frontmatter contracts, URL routing, and content authoring conventions.
- Content Sections and Routes — Implementation reference for C5 section components, route templates, docs-index behavior, and fragment utility integration.
- Image Resilience — How broken images degrade gracefully via a site-configurable fallback placeholder.
- MDX Content Authoring — How to use MDX to combine Markdown content with Astro components for rich page layouts.