Content Model
Content Model
Section titled “Content Model”The canonical source lives in shared-content/ and uses only the Markdown
features that all current generators handle cleanly:
- short frontmatter with titles and descriptions
- relative links between pages
- section hubs with
index.md - plain headings, lists, tables, and code fences
Why This Matters
Section titled “Why This Matters”The less generator-specific syntax you put in the content, the easier it is to rebuild or swap the rendering layer later.
Practical Rule
Section titled “Practical Rule”If a page needs a special feature that only one generator understands, treat it as an exception and isolate it. The default path should stay portable.