Topic: organization

A markdown file is the page. No wrapper folder, no required frontmatter -- titles come from headings. Best for documentation, wikis, and serving an existing repository as-is.

A directory is the page. An index file carries the content, and everything beside it -- images, modules, child pages -- belongs to that page. Best for media-rich sites and composable landing pages.

Folder pages and file pages coexist in the same content tree. Use folders where assets matter and files where they do not -- the storage model is invisible downstream.

How a page's location and frontmatter bind it to a document model, and which frontmatter fields a model may govern.

Point Accent at any folder of markdown -- a project's docs, a notes directory, a repository root -- and it serves immediately, with no restructuring and no frontmatter.

A markdown file is the page. No wrapper folder, no required frontmatter -- titles come from headings. Best for documentation, wikis, and serving an existing repository as-is.

A directory is the page. An index file carries the content, and everything beside it -- images, modules, child pages -- belongs to that page. Best for media-rich sites and composable landing pages.

Folder pages and file pages coexist in the same content tree. Use folders where assets matter and files where they do not -- the storage model is invisible downstream.

How a page's location and frontmatter bind it to a document model, and which frontmatter fields a model may govern.

Point Accent at any folder of markdown -- a project's docs, a notes directory, a repository root -- and it serves immediately, with no restructuring and no frontmatter.