# Better Static Sites docs

> Documentation for the Better Static Sites (astro-better-*) family of Astro integrations and components.

## Build Tools

- [Code Snippets](https://better-static-sites.github.io/build-tools/code-blocks.md): Remark/rehype plugins for enhanced code blocks with copy button, line highlighting, diff mode, collapsible sections, file titles, and shell session formatting.
- [Code Snippet Extraction](https://better-static-sites.github.io/build-tools/code-snippet-extractor.md): Load Bluehawk-annotated code snippets and local source files into Astro pages.
- [Markdown Page Generation](https://better-static-sites.github.io/build-tools/gen-markdown-pages.md): Generates .md companion files and llms.txt from built HTML pages at build time.
- [Link Checker](https://better-static-sites.github.io/build-tools/link-checker.md): Fast intra-site broken link and image checker that deduplicates destinations.
- [Mermaid Diagram Renderer](https://better-static-sites.github.io/build-tools/mermaid.md): Server-side Mermaid diagram rendering to inline SVG at build time.
- [Anchor References](https://better-static-sites.github.io/build-tools/refs.md): Sphinx-style named anchors that survive content moves.

## Build Tools.md

- [Build Tools](https://better-static-sites.github.io/build-tools.md): Integrations that run at build time to enhance content or validate the site.

## Content

- [Admonitions](https://better-static-sites.github.io/content/admonitions.md): Extensible callout boxes and inline badges for Astro MDX.
- [Cards](https://better-static-sites.github.io/content/cards.md): Link cards, child-page grids, and prev/next page navigation.
- [Declarative Screenshots](https://better-static-sites.github.io/content/declarative-screenshots.md): Declarative, Docker-backed screenshots for Astro docs. Define screenshots in MDX; generate PNGs on demand and commit them.
- [Collapsible Content](https://better-static-sites.github.io/content/details.md): Native details/summary disclosure panels with animated chevron and CSS custom property theming.
- [Linked Steps](https://better-static-sites.github.io/content/steps.md): Numbered step sequences with CSS counters and a connecting vertical line.
- [Tables](https://better-static-sites.github.io/content/tables.md): RST-style list-table and grid-table components for structured data.
- [Tabs](https://better-static-sites.github.io/content/tabs.md): Zero-JavaScript tabbed content panels with CSS custom property theming.

## Content.md

- [Content](https://better-static-sites.github.io/content.md): Components you drop into MDX pages to add structured content.

## Index.md

- [Overview](https://better-static-sites.github.io/index.md): Documentation for the astro-better-* family of Astro integrations and components.

## Layout

- [Navigation Sidebar](https://better-static-sites.github.io/layout/docs-sidebar.md): Auto-building docs sidebar from a content collection, with tree expansion and active-page tracking.
- [Top Nav/Menu Bar](https://better-static-sites.github.io/layout/nav-bar.md): Configurable top navigation bar with dropdowns, theme selector, search, login link, and CTA button.
- [Release Notes](https://better-static-sites.github.io/layout/release-notes.md): Versioned changelogs with category filtering and version dropdown navigation.
- [Table of Contents](https://better-static-sites.github.io/layout/toc.md): Server-side table of contents with scroll spy and optional inline mobile accordion, injected at build time.

## Layout.md

- [Layout](https://better-static-sites.github.io/layout.md): Integrations that power the site layout itself.

## Release Notes.md

- [Release Notes](https://better-static-sites.github.io/release-notes.md): Changelog for the astro-better-* package family.