# Build Sites

URL: /bengal/docs/build-sites/
Section: build-sites
Description: Write, structure, customize, and extend your Bengal site

---

> For a complete page index, fetch /bengal/llms.txt.

Everything between first draft and production deploy: authoring, site structure,
theming, and extensions.

Note

Do I need this? Writers start in Write (/bengal/docs/build-sites/write/).
Theme developers go to Customize (/bengal/docs/build-sites/customize/).
Plugin authors see Extend (/bengal/docs/build-sites/extend/).
Operators shipping builds should use Ship (/bengal/docs/ship/) instead.

Write

Author content, reuse snippets, and apply MyST directives

(/bengal/docs/build-sites/write/)

Structure

Organize pages, collections, i18n, versioning, and site analysis

(/bengal/docs/build-sites/structure/)

Theming

Templates, assets, and visual customization

(/bengal/docs/build-sites/customize/)

Extending Bengal

Create custom directives, content sources, collections, and build hooks

(/bengal/docs/build-sites/extend/)

## By task

I want to…
Go to…

Write Markdown and directives
Write (/bengal/docs/build-sites/write/)

Organize pages, menus, versions
Structure (/bengal/docs/build-sites/structure/)

Customize templates and CSS
Customize (/bengal/docs/build-sites/customize/)

Add plugins, sources, directives
Extend (/bengal/docs/build-sites/extend/)

## In This Section

Write (/bengal/docs/build-sites/write/)

Author content, reuse snippets, and apply MyST directives

1 page

Structure (/bengal/docs/build-sites/structure/)

Organize pages, collections, i18n, versioning, and site analysis

1 page

Theming (/bengal/docs/build-sites/customize/)

Templates, assets, and visual customization

3 pages

Extending Bengal (/bengal/docs/build-sites/extend/)

Create custom directives, content sources, collections, and build hooks

9 pages

Related Pages

Get Started (/bengal/docs/get-started/)

Install Bengal and create your first site

Related

Assets (/bengal/docs/build-sites/customize/assets/)

CSS, JavaScript, images, and fonts

Related

The Component Model (/bengal/docs/build-sites/structure/organization/component-model/)

Understanding Bengal's Component Model: Identity, Mode, and Data.

Related

Component Model Reference (/bengal/docs/build-sites/structure/organization/component-model-reference/)

Exhaustive type, variant, props, cascade, and skeleton examples for Bengal's component model

Related

persona-writer (/bengal/tags/persona-writer/)

persona-themer (/bengal/tags/persona-themer/)

persona-extender (/bengal/tags/persona-extender/)
