# Denote

> Denote documentation

## Docs

- [AI Native](https://denote.sh/docs/ai-native): Denote serves docs to both humans and AI agents. Three layers of AI access - llms.txt for discovery, JSON API for structured data and RAG pipelines, and MCP server for live tool integration with Cursor, Claude, and ChatGPT. All auto-generated from markdown, zero config.
- [API Reference](https://denote.sh/docs/api): REST API endpoints for programmatic access. GET /api/docs returns structured JSON, GET /api/search returns the search index, GET /llms.txt and /llms-full.txt provide AI-optimized markdown, serves MCP protocol over Streamable HTTP.
- [Components](https://denote.sh/docs/components): Built-in server components (Header, Sidebar, DocsLayout, PageLayout, EditLink) and Preact islands (Search, CollapsibleNav, ActiveToc, ThemeToggle, CopyButton, MobileMenu) with their props and behavior.
- [Configuration](https://denote.sh/docs/configuration): Configure Denote via denote.config.ts. Covers site name, navigation tree, colors, fonts, layout, SEO metadata, analytics, social links, landing page, and AI features (MCP, llms.txt).
- [Writing Content](https://denote.sh/docs/content): Write documentation in Markdown with YAML frontmatter (title, description, ai-summary, ai-keywords). Supports GFM syntax, code highlighting, tables, task lists, and single-line paragraph convention.
- [Custom Pages](https://denote.sh/docs/custom-pages): Add standalone routes (legal, about, landing pages) outside the docs layout. Fresh file-system routing with automatic PageLayout wrapping and access to DenoteContext.
- [Deployment](https://denote.sh/docs/deployment): Deploy Denote to Deno Deploy (recommended one-click), Docker, or any Deno-capable host. Covers production builds, environment variables, GitHub Actions CI/CD, and custom domain setup.
- [Installation](https://denote.sh/docs/installation): Install Denote via deno init with the @denote/init scaffolder. Requires Deno 2.x. Creates a ready-to-run project with config, content directory, routes, and dev server.
- [Welcome to Denote](https://denote.sh/docs/introduction): Denote is an open-source, AI-native documentation framework. It auto-generates llms.txt, JSON API, and MCP server endpoints so AI agents can consume your docs as structured data. Zero config, server-rendered, markdown-first.
- [Quick Start](https://denote.sh/docs/quickstart): Step-by-step guide to create your first Denote documentation page. Covers creating markdown files with frontmatter, adding navigation entries, and running the dev server.
- [Theming & Styling](https://denote.sh/docs/theming): Theme Denote via CSS custom properties (--denote-* tokens) driven by config. Covers color palette with auto-derived dark mode, font imports, layout dimensions, roundedness presets, and custom CSS injection.

## API

- [Full docs as markdown](https://denote.sh/llms-full.txt): Complete documentation in a single markdown file
- [Structured JSON](https://denote.sh/api/docs): All documentation pages as structured JSON

## MCP (Model Context Protocol)

For richer AI integration, connect via MCP at `https://denote.sh/mcp` (Streamable HTTP transport).
Tools: search_docs, get_doc, get_all_docs. Resources: docs://index, docs://{slug}.