> ## Documentation Index
> Fetch the complete documentation index at: https://margin.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://margin.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://margin.manicule.dev/api/mcp.
> Every agent surface: https://margin.manicule.dev/.well-known/llms-manifest.json

# Margin (/)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 339 · updated: 2026-10-27 -->
Related: [Configuration](/configuration.md), [Deploy](/deploy.md), [Extensions](/extensions.md), [Agents and discovery](/agents.md), [Link relations](/link-relations.md)

> Publish a documentation folder as a searchable, versioned site.

Margin is a modern, agent-first framework for documentation. It turns
Markdown and MDX into a documentation site backed by Postgres. It builds navigation from your files, accepts supported Mintlify
configuration, and exposes the same content to readers and agents.

## Start with one page

A documentation folder needs only one page:

```text
docs/
└── index.mdx
```

Write a heading and some prose. The framework derives the title, URL,
sidebar, and default appearance. Add `docs.json` when you need a display
name, explicit navigation, colors, or other configuration.

## Run locally

From the repository root, with Bun and Docker installed:

```bash
bun install
cp .env.example .env
docker compose up -d --wait postgres
bun run db:migrate
bun run dev
```

Open `http://localhost:3000`. Edits under `docs/` trigger ingest while the dev
server is running. The database uses port 5440 by default.

## Choose the next step

* [Configure titles, navigation, and themes](/configuration).
* [Deploy to Vercel or your own server](/deploy).
* [Replace the server extension module](/extensions).
* [Connect agents to Markdown, MCP, and skills](/agents).

This documentation is itself a folder the framework ingests. The same
validation, content-versioning, and serving rules apply to your site.