Build documentation with Dahlia
Start from the template or add Dahlia to an existing Astro project, then configure the shell and write MDX.
Start with a working site
New documentation site
Create a complete Dahlia project from the maintained starter template and replace its example configuration and content.
Existing Astro project
Follow a copy-paste setup that includes the integration, content collection, theme config, first page, and expected URL.
Complete common tasks
Write content
Create pages with frontmatter, Markdown, MDX, images, code blocks, callouts, and Mermaid diagrams.
Configure navigation
Organize content entry IDs into sections, nested groups, and autogenerated directory listings.
Use MDX components
Copy working examples for callouts, cards, steps, tabs, accordions, file trees, media, embeds, badges, and icons.
Customize Dahlia
Start with appearance options and CSS tokens, then override a shell component only when configuration is not enough.
Add languages
Map locale directories to URLs and understand fallback content, translated navigation labels, edit links, and search indexes.
Build and deploy
Validate the project, build static output, verify search, and publish the
generated dist/ directory.
Useful references
- Configuration reference lists every
theme.config.jsonoption. - Theme tokens lists the public CSS variables.
- Troubleshooting maps common symptoms to concrete checks.
- Changelog explains behavior changes between releases.