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.