# Content Organization

URL: /docs/content/organization/
Section: organization

--------------------------------------------------------------------------------

How Content is Organized Your folder structure becomes your site structure. No configuration required. The Three Content Types flowchart TB subgraph "Your Files" A["📄 about.md"] B["📁 blog/_index.md"] C["📦 gallery/index.md"] end subgraph "Your Site" D["/about/"] E["/blog/ + children"] F["/gallery/ + assets"] end A --> D B --> E C --> F 📄 Page 📁 Section 📦 Bundle A single .md file → a single HTML page. content/ └── about.md → /about/ Use for: standalone pages like About, Contact, Privacy Policy. A folder with _index.md → a list page with children. content/ └── blog/ ├── _index.md → /blog/ (list page) ├── post-1.md → /blog/post-1/ └── post-2.md → /blog/post-2/ Use for: blog posts, documentation chapters, any collection. A folder with index.md → a page with co-located assets. content/ └── gallery/ ├── index.md → /gallery/ ├── photo-1.jpg (private to this page) └── photo-2.jpg (private to this page) Use for: pages with images, data files, or other assets. Quick Reference Pattern File Creates Assets Page name.md Single page Use static/ Section name/_index.md List + children Use static/ Bundle name/index.md Single page Co-located Tip Tip Key difference: _index.md creates a section (with children). index.md creates a bundle (with assets). The underscore matters! Settings Advanced: Nesting and Cascades Sections can nest to any depth: docs/ ├── _index.md ├── getting-started/ │ ├── _index.md │ └── installation.md └── advanced/ ├── _index.md └── plugins.md Configuration cascades from parent to children: 1 2 3 4 5 6--- title: Docs cascade: type: doc toc: true --- All pages under docs/ inherit type: doc and toc: true unless they override it.

--------------------------------------------------------------------------------

Metadata:
- Author: lbliii
- Word Count: 258
- Reading Time: 1 minutes