---
title: docs-builder
description: docs-builder is Elastic's distributed documentation platform. It processes Markdown from multiple repositories into unified documentation sites, validates...
url: https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder
products:
  - Elastic Docs Builder
---

# docs-builder
docs-builder is Elastic's distributed documentation platform. It processes Markdown from multiple repositories into unified documentation sites, validates cross-repo references, and ships as native AOT binaries for CI.

## What does docs-builder produce?


### Documentation builds

docs-builder builds documentation across many repositories independently, then assembles them into unified experiences. There are three build modes:
- **[Assembler builds](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation/assembler)** — Compose a global navigation over many repositories to produce a unified documentation site. Powers sites like [elastic.co/docs](https://www.elastic.co/docs/).
- **[Codex builds](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation/codex)** — Create knowledge base environments where repositories publish independently at `/r/<repo>`, optionally grouped under `/g/<group>`.
- **[Isolated builds](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation/isolated)** — Build a single repository's docs locally or as a PR preview.

Learn more about the [distributed documentation model](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation).

### Reference generation

- **[OpenAPI](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/openapi)** — Generate interactive API reference documentation from OpenAPI specifications.
- **[CLI Schema](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/cli-schema)** — Generate CLI reference documentation from [CLI Schema](https://cli-schema.org) files.


### Release notes

- **[Release notes](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/release-notes)** — Create, bundle, and publish release documentation from structured changelog files.


### Docs as data

- **[Exporters](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/exporters)** — Export documentation as Elasticsearch documents, LLM Markdown, OKF, and plain text.
- **[MCP server](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/mcp)** — Let AI assistants and coding agents interact with Elastic documentation via the Model Context Protocol.
- **[REST API](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/data/api)** — Search, ask questions, and query documentation changes programmatically.


### Integrations

- **[docs-actions](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/integrations/docs-actions)** — Reusable GitHub Actions for documentation CI/CD.
- **[Elastic CLI](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/integrations/elastic-cli)** — Search and read documentation from the `elastic` CLI.


## Get started

New to docs-builder? Start here:
- **[Getting started](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/getting-started)** — Choose your path based on what you want to build.
- **[Installation](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/getting-started/installation)** — Install the docs-builder CLI.


## Authoring & reference

- **[Syntax reference](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/syntax)** — Markdown syntax with MyST directives and roles.
- **[Configuration](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation/isolated/configure)** — Site-level, content-set, and page-level configuration.
- **[How-to guides](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/documentation/isolated)** — Guides for managing files, repositories, and releases.
- **[CLI reference](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/cli)** — All docs-builder commands and options.


## Development

- **[Development guide](https://www.elastic.co/elastic/docs-builder/docs/3763/reference/docs-builder/dev)** — Building blocks, link infrastructure, navigation system, and contributing to docs-builder.