Guides

Themes - the built-in themes, and how to write your own
Search - how the static search index works
Deploying to GitHub Pages - the built-in GitHub Actions workflow
Markdown Extensions - admonitions, footnotes, definition lists and Mermaid diagrams
Content Blocks - GitBook-style blocks: expandables, cards, columns, a stepper, and reusable content includes
Responsive Images - automatic resizing, WebP variants, and CSS/JS bundling, on by default
Interactivity with Alpine.js - reactive content (copy buttons, live filters, and more) with no extra setup
Blog - a by-convention blog: posts, authors, categories, archives, RSS, and stats
Plugins - extending BX Sites with a BoxLang module of your own
Versioning - snapshot a release's docs and get a version switcher for free
Internationalization (i18n) - translating your docs into other languages
Migrating from GitBook - convert a GitBook export into a bx-sites project with one command
Migrating from mkdocs - convert an mkdocs project into a bx-sites project with one command

Edit this page Download Markdown Last updated Aug 23, 2026, 2:17:28 AM