Introduction

comark-docs is a Nuxt layer for documentation sites, powered by comark-content. It runs the docs for Comark, Comark Content, and devfra.me — including the site you're reading now.

Most docs frameworks bundle Markdown into the build, so every typo fix means a redeploy. With comark-docs, content lives as Markdown in your repository and is fetched, parsed, and cached at request time. Push to your production branch and the change is live in seconds — no build, no deploy.

How it works

In development, pages are read from your working tree with hot reload. In production, they're read from GitHub, pinned to a commit SHA, and cached at two levels: parsed Markdown bodies in a runtime cache and rendered HTML at the edge with ISR.

A GitHub webhook notifies the site on push, which purges the cached pages. Because content is addressed by commit, any branch or commit can also be previewed live at /tree/:branch or /blob/:sha — see Versioned previews.

What's included

• Instant production content — GitHub-sourced Markdown, ISR-cached HTML, revalidated on push.
• Versioned previews — browse any branch or commit of your docs through versioned URLs.
• Docs UI built with Nuxt UI: sidebar navigation, search (⌘K), table of contents, prev/next links, and a version history panel.
• SEO out of the box — sitemap, robots, canonical URLs, OG images, and JSON-LD structured data.
• AI-native — llms.txt, raw Markdown mirrors (/raw/**), an MCP server (/mcp), an optional "Ask AI" assistant, and Agent Skills discovery.

Keyboard shortcuts

Every site built with the layer ships these shortcuts — try them on this page:

Single-key shortcuts are ignored while an input is focused, so they never conflict with typing.

Next steps