Start Here
New to Bengal? Start here to build documentation sites, blogs, knowledge bases, and product sites with Python. Bengal covers authoring, search, SEO/discovery, theming, deployment, and performance in one toolchain.
Get Started
Install Bengal and create your first site
Tutorials
Guided learning journeys to master Bengal
Write & Organize
Author content in Markdown, structure your site, and validate quality.
Author
Markdown, MyST directives, code blocks, and callouts
Organize
Pages, sections, bundles, and frontmatter
Reuse
Snippets, data files, and DRY patterns
Validate
Health checks, linting, and auto-fixes
Version
Maintain multiple doc versions side-by-side
Analyze
Find orphan pages and optimize internal linking
Customize
Control appearance with themes, templates, and CSS. Add custom directives, content sources, and build hooks.
Theming
Templates, assets, and visual customization
Extending Bengal
Custom directives, content sources, collections, and build hooks
Build & Ship
Configure builds, optimize performance, improve SEO/discovery, and deploy to production.
Configure
Site settings, environments, and build options
SEO & Discovery
Metadata, sitemap, feeds, canonical URLs, social cards, and search
Performance
Incremental builds, caching, and parallel processing
Deploy
GitHub Pages, Netlify, Vercel, and CI/CD
Troubleshoot
Common issues and how to resolve them
Look It Up
Technical specifications, directive syntax, architecture details, and project background.