---
title: Guides
order: 5
icon: phosphor-duotone:book-open
---

# Guides

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