write-docs-pages

name	write-docs-pages
description	Author Markdown pages for a comark-docs site. Use when adding or editing content under content/, writing MDC, callouts, code blocks, or navigation YAML.

Write docs pages

Pages live as Markdown under content/. Numeric prefixes order sections and files; they are stripped from the URL.

content/
├── index.md                          → /
├── 1.getting-started/
│   ├── .navigation.yml
│   ├── 1.introduction.md             → /getting-started/introduction
│   └── 2.installation.md             → /getting-started/installation
└── 2.concepts/
    └── 1.architecture.md             → /concepts/architecture

Frontmatter

---
title: Installation
description: Add the layer to a Nuxt app.
---

description is used in search, llms.txt, and OG images. Set navigation: false to hide a page from the sidebar (the landing page does this).

MDC

Nuxt UI components in Markdown need the u- prefix (::u-page-hero, :::u-button). Layer extras used in these docs:

• ::note / ::callout — asides
• ::code-group / ::code-preview — tabbed and previewed code
• ::landing-features / :::landing-feature-card — landing grid

Code fences support {1-3} line highlights and [filename.ts] labels. Mermaid fences render as diagrams.

See Markdown for the full syntax, Components for the available blocks, and references/page-skeleton.md for a starter page.