# Documan.ai

> Documan.ai documentation, available as raw markdown for AI agents and LLMs. Append `.md` to any page URL, or send `Accept: text/markdown`.

## 🚀 Quick start
- [🚀 Quick start](https://docs.documan.ai/index.md): Set up a documentation site from Markdown files with an interactive quickstart. Choose Docker or standalone binary, configure your project, and start serving.

## 📖 Getting started
- [📖 Getting started](https://docs.documan.ai/getting-started.md): Complete guide to setting up and configuring Documan for your project.
- [Frontmatter guide](https://docs.documan.ai/getting-started/markdown-frontmatter.md): Complete guide to frontmatter metadata fields in Documan markdown files for navigation and layout.
- [Showcase](https://docs.documan.ai/getting-started/markdown-showcase.md): Complete demonstration of all supported markdown features and rendering capabilities.
- [Commands](https://docs.documan.ai/getting-started/commands.md): Overview of all Documan CLI commands for managing documentation.

## ⚙️ Configuration
- [⚙️ Configuration](https://docs.documan.ai/configuration.md): All Documan environment variables, grouped by area — general server settings, semantic search, and the AI chat assistant.
- [General](https://docs.documan.ai/configuration/general.md): Core Documan environment variables — project name, file globs, database path, HTTP port, AI discovery surfaces, and license key.
- [Semantic search](https://docs.documan.ai/configuration/semantic-search.md): OpenAI embedding variables that power the vectorize command and semantic search — API key, base URL, embedding model, and chunk size.
- [AI chat](https://docs.documan.ai/configuration/ai-chat.md): Configure the AI chat assistant — a grounded, multi-agent chat with your documentation that answers with verified citations. Full reference for all DOCUMAN_CHAT_* environment variables.

## 🚢 Deployment
- [🚢 Deployment](https://docs.documan.ai/deployment.md): Docker setup, Docker Compose, and CI/CD integration for deploying Documan.
- [Docker setup](https://docs.documan.ai/deployment/docker-setup.md): Production Dockerfile for Documan with build-time validation, import, and vectorization.
- [Docker Compose](https://docs.documan.ai/deployment/docker-compose-setup.md): Local development setup with Docker Compose and live file changes.
- [CI/CD integration](https://docs.documan.ai/deployment/ci-cd-integration.md): Validate and deploy documentation automatically in your CI/CD pipeline.

## 🤖 AI integration
- [🤖 AI integration](https://docs.documan.ai/ai-integration.md): Connect AI coding tools to your documentation via MCP server and custom skills.
- [MCP setup](https://docs.documan.ai/ai-integration/mcp-setup.md): How to connect Documan MCP server to AI coding tools like Claude Code, Cursor, Windsurf, and others.
- [AI coding skill](https://docs.documan.ai/ai-integration/documan-skill.md): Add a Documan skill to your AI coding tool for creating and editing documentation automatically.
- [AI chat](https://docs.documan.ai/ai-integration/ai-chat.md): An optional, grounded "chat with your documentation" assistant that answers visitor questions with verified citations back to your pages.

## 🗺️ Roadmap
- [🗺️ Roadmap](https://docs.documan.ai/roadmap.md): Feature roadmap and development priorities for Documan project.

## Optional
- [MCP endpoint](https://docs.documan.ai/mcp): Model Context Protocol server for programmatic, token-efficient access to this documentation.