# Content

URL: /bengal/docs/content/
Section: content
Description: Author, organize, and validate your documentation

---

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

Bengal transforms Markdown files into structured, validated documentation sites with rich directives, cross-references, and automated validation.

## What Do You Need?

Content Organization

Pages, sections, and bundles explained

(/bengal/docs/content/organization/)

Content Authoring

Markdown, MyST directives, and rich content

(/bengal/docs/content/authoring/)

Internationalization (i18n)

Multi-language sites with gettext PO/MO, RTL support, and translation workflows

(/bengal/docs/content/i18n/)

Content Collections

Validate frontmatter with typed schemas

(/bengal/docs/content/collections/)

Content Sources

Fetch content from external sources

(/bengal/docs/content/sources/)

Analysis

Site structure analysis tools

(/bengal/docs/content/analysis/)

Content Reuse

Snippets, data files, and DRY patterns

(/bengal/docs/content/reuse/)

Versioned Documentation

Serve multiple versions of your documentation from a single site

(/bengal/docs/content/versioning/)

Validation

Content validation and health checks

(/bengal/docs/content/validation/)

## How Content Flows

flowchart LR
subgraph Sources
A[Local .md files]
B[GitHub repos ⚡]
C[Notion/APIs ⚡]
end

subgraph Processing
D[Discovery]
E[Frontmatter Parsing]
F[MyST Directives]
G[Cross-References]
end

subgraph Output
H[HTML Pages]
end

A --> D
B --> D
C --> D
D --> E
E --> F
F --> G
G --> H

Note

⚡ Remote sources require optional dependencies. Install with`pip install bengal[all-sources]` or individually: `bengal[github]`, `bengal[notion]`, `bengal[rest]`.

## Key Features

Feature
Description

Component Model
`type`, `variant`, and `props`define page identity, appearance, and data

MyST Directives
Tabs, cards, admonitions, code blocks, and 60+ directives

Cross-References
`[[path]]`syntax with O(1) lookups and auto-title resolution

Validation
`bengal validate`checks links, directives, and frontmatter

Graph Analysis
`bengal graph report`finds orphan pages and suggests links

Tip

New to Bengal? Start with Organization (./organization/) to understand how files become pages, then explore Authoring (./authoring/) for MyST syntax.

Working on a larger site? Use Analysis (./analysis/) to optimize internal linking and Validation (./validation/) for automated quality checks.

## In This Section

Content Organization (/docs/content/organization/)

Pages, sections, and bundles explained

4 pages

Content Authoring (/docs/content/authoring/)

Markdown, MyST directives, and rich content

9 pages

Internationalization (i18n) (/docs/content/i18n/)

Multi-language sites with gettext PO/MO, RTL support, and translation workflows

4 pages

Content Collections (/docs/content/collections/)

Validate frontmatter with typed schemas

1 page

Content Sources (/docs/content/sources/)

Fetch content from external sources

2 pages

Analysis (/docs/content/analysis/)

Site structure analysis tools

2 pages

Content Reuse (/docs/content/reuse/)

Snippets, data files, and DRY patterns

3 pages

Versioned Documentation (/docs/content/versioning/)

Serve multiple versions of your documentation from a single site

5 pages

Validation (/docs/content/validation/)

Content validation and health checks

2 pages

Multilingual Sites (/bengal/docs/content/i18n/)

Serve your documentation in multiple languages with proper URL routing and translations