Begin with a few Markdown files. As a topic grows, move related articles into a subsection. The homepage includes posts from nested sections automatically.

Use a page bundle

A folder containing index.md and its images keeps an article’s assets together. Add a hero.jpg or set hero in front matter to customize its card image.

Keep useful paths

Choose clear slugs and preserve published URLs when reorganizing. Hugo aliases can redirect readers from old paths.