# Nested Documentation

Pages can be organized into folders to keep your documentation structured.

## Why Use Folders?

- **Organization** -- Group related topics together
- **Clean URLs** -- Pages get nested URLs like `/folder/page`
- **Scalability** -- Keeps large documentation sets manageable

## Example Structure

```
markdown/
├── README.md           # /
├── guide.md            # /guide
├── api/
│   ├── README.md       # /api
│   ├── authentication.md  # /api/authentication
│   └── endpoints.md    # /api/endpoints
└── deployment/
    └── README.md       # /deployment
```

## Navigation

Folders appear as collapsible sections in the sidebar. Click the folder name to expand or collapse its contents. The current page is highlighted automatically.