Advanced Usage

Source   Edit  

Advanced Usage

Multi-Page Projects

For large documentation projects, organize your files into chapters and sections using subdirectories:

src/
├── SUMMARY.md
├── index.md
├── ch01/
│   ├── index.md
│   ├── intro.md
│   └── advanced.md
└── ch02/
    ├── index.md
    └── reference.md

Each subdirectory can have its own importdoc chain. The top-level SUMMARY.md defines the navigation structure, while individual files use .. importdoc:: to reference content from other sections.

Tip: Keep your pages focused. A good rule of thumb is one major concept per page. This improves both navigation and search relevance.