---
title: "A Nuxt layer for content-driven documentation"
description: "comark-docs is a Nuxt layer for documentation sites powered by comark-content: Markdown served at request time, ISR-cached, revalidated on push."
canonical_url: "https://docs-template.comark.dev"
---
# A Nuxt layer for content-driven documentation

> comark-docs is a Nuxt layer for documentation sites powered by comark-content: Markdown served at request time, ISR-cached, revalidated on push.

<landing-hero orientation="horizontal">
#title
Docs that ship without a redeploy.



#description
The first Markdown-driven docs site where content goes live on `git push`. No rebuild, no redeploy. Served at request time through [Comark Content](https://content.comark.dev), cached at the edge, revalidated by a webhook. And every branch or commit is already a live preview.



#links
<button to="https://docs-template.comark.dev/getting-started/introduction" size="lg" trailing-icon="i-lucide-arrow-right">
Get started
</button><button to="https://docs-template.comark.dev/concepts/architecture" size="lg" color="neutral" variant="outline">
How it works
</button>



#default
```ts [nuxt.config.ts]
export default defineNuxtConfig({
  extends: ['comark-docs'],
  site: {
    url: 'https://docs.example.com',
    name: 'My Project',
  },
})
```
</landing-hero>

<landing-features>
#headline
Features



#title
Everything a docs site needs



#default
<landing-feature-card icon="i-lucide-zap" to="https://docs-template.comark.dev/concepts/architecture">
#title
Instant content



#description
Push Markdown to your production branch and it's live in seconds. A webhook purges exactly the pages that changed.
</landing-feature-card><landing-feature-card icon="i-lucide-git-branch" to="https://docs-template.comark.dev/concepts/versioned-previews">
#title
Versioned previews



#description
Every branch renders at `/tree/branch`, every commit at `/blob/sha` with full navigation and search, skip new deploys.
</landing-feature-card><landing-feature-card icon="i-lucide-panels-top-left" to="https://docs-template.comark.dev/writing/components">
#title
Docs UI included



#description
Sidebar navigation, search (`⌘K`), table of contents, prev/next links, and a version history panel — built with Nuxt UI.
</landing-feature-card><landing-feature-card icon="i-lucide-search" to="https://docs-template.comark.dev/writing/navigation">
#title
SEO out of the box



#description
Sitemap, canonical URLs, OG images, and JSON-LD structured data, all generated from your content tree.
</landing-feature-card><landing-feature-card icon="i-lucide-bot" to="https://docs-template.comark.dev/getting-started/introduction">
#title
AI-native



#description
`llms.txt`, raw Markdown mirrors, an MCP server, Agent Skills discovery, and an optional "Ask AI" assistant.
</landing-feature-card><landing-feature-card icon="i-lucide-message-square-text" to="https://docs-template.comark.dev/deployment/pr-preview-comments">
#title
Review-friendly



#description
A GitHub Action comments on content PRs with instant preview links for every changed page.
</landing-feature-card>
</landing-features>

<landing-faq items="[{\"label\":\"Do I need to redeploy when content changes?\",\"content\":\"No. Content is fetched from GitHub at request time and cached. A push to the production branch triggers a webhook that purges the changed pages — they're live within seconds, and the build is skipped entirely.\"},{\"label\":\"How do I preview a branch or a pull request?\",\"content\":\"Any branch renders live at `/tree/branch-name`, any commit at `/blob/sha`, with that version's own navigation and search. An optional GitHub Action posts the links on pull requests.\"},{\"label\":\"Is it slow to parse Markdown on every request?\",\"content\":\"Pages are parsed once per commit, not per request. Rendered HTML is ISR-cached at the edge and parsed content is cached by commit SHA, so warm pages are served without touching GitHub at all.\"},{\"label\":\"How do I install it?\",\"content\":\"It isn't on npm yet — install it from GitHub with `pnpm add comark-docs@github:comarkdown/comark-docs` and add `extends: ['comark-docs']` to your Nuxt config.\"}]">
#headline
FAQ



#title
Frequently asked questions
</landing-faq>

<landing-cta>
#title
Ready to ship docs faster?



#description
Install the layer, write Markdown in `content/`, and push. This site is the playground — everything you see here is built with it.



#links
<button to="https://docs-template.comark.dev/getting-started/installation" size="lg" trailing-icon="i-lucide-arrow-right">
Install comark-docs
</button><button to="https://github.com/comarkdown/comark-docs" size="lg" color="neutral" variant="outline" icon="i-simple-icons-github" target="_blank">
Star on GitHub
</button>
</landing-cta>

## Resources for Agents

- [API catalog: every service document this site publishes](https://docs-template.comark.dev/.well-known/api-catalog)
- [Sitemap (XML)](https://docs-template.comark.dev/sitemap.xml)
- [Sitemap (Markdown): every page on the site](https://docs-template.comark.dev/sitemap.md)
- [MCP server card: MCP endpoint at https://docs-template.comark.dev/mcp](https://docs-template.comark.dev/.well-known/mcp/server-card.json)
- [MCP endpoint (streamable HTTP)](https://docs-template.comark.dev/mcp)
- [llms.txt: index of the documentation for LLMs](https://docs-template.comark.dev/llms.txt)
- [llms-full.txt: the full documentation as a single file](https://docs-template.comark.dev/llms-full.txt)
- [Agent skills index: every skill published by this site](https://docs-template.comark.dev/.well-known/skills/index.json)
- [Agent skill: extend-comark-docs](https://docs-template.comark.dev/.well-known/skills/extend-comark-docs/SKILL.md)
- [Agent skill: preview-versions](https://docs-template.comark.dev/.well-known/skills/preview-versions/SKILL.md)
- [Agent skill: write-docs-pages](https://docs-template.comark.dev/.well-known/skills/write-docs-pages/SKILL.md)
- [OpenAPI document: every route this site serves to agents](https://docs-template.comark.dev/openapi.json)
- [RSS feed of the documentation](https://docs-template.comark.dev/rss.xml)


## Sitemap

See the full [sitemap](https://docs-template.comark.dev/sitemap.md) for all pages.