Write plain Markdown, then opt into Vyasa features like callouts, tabs, Mermaid, D2, math, footnotes as sidenotes, and code snippet includes only when the page needs them.
Keep content organized as folders; index.md or README.md becomes the landing page for that branch.
Use a blog-style homepage at / when you want the newest posts first, or set home_sort = "name_asc" / home_sort = "name_desc" to order homepage cards by filename instead.
Style the site with normal CSS and bundled theme presets instead of introducing a component system.
Use the same content tree for a live local server and a static export.
Add auth and RBAC when the content stops being public or personal.