---
title: docs-builder documentation hub
description: docs-builder documentation. Build, validate, and publish Elastic documentation from Markdown across many repositories.
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/3827/examples/products/docs-builder
products:
  - Elastic Docs Builder
---

# docs-builder documentation hub
The toolchain that builds Elastic's documentation. Author in Markdown, validate cross-repository links, preview locally, and publish one unified site.
- [Install docs-builder](https://docs-v3-preview.elastic.dev/getting-started/installation)
- [Elastic documentation](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/get-started)
- [Explore docs-builder](#explore)

## Get started in 3 steps
Install docs-builder, write your first page, then preview and publish it.
1. Install docs-builder
   - Build from source: Clone the repository and build the CLI yourself.
     `dotnet build`
   - Run in a container: No local install needed.
     [Container setup](https://docs-v3-preview.elastic.dev/getting-started/installation)
2. [Write your first page](https://docs-v3-preview.elastic.dev/getting-started/writing-content)
   Author Markdown, add links, and use the directive set.
3. Preview and publish
   Serve the site locally with live reload, then publish it.

### Get hands-on
New to the toolchain? Follow a guided path from install to published page.

#### [Write your first page](https://docs-v3-preview.elastic.dev/getting-started/writing-content)
Author a page, add links, and preview it locally.
- [Writing content](https://docs-v3-preview.elastic.dev/getting-started/writing-content)
- [Pages and links](https://docs-v3-preview.elastic.dev/getting-started/pages-and-links)

#### [Serve and publish](https://docs-v3-preview.elastic.dev/getting-started/serve)
Run the local preview server, then publish the built site.
- [Serve locally](https://docs-v3-preview.elastic.dev/getting-started/serve)
- [Publish](https://docs-v3-preview.elastic.dev/getting-started/publish)

#### [Syntax reference](https://docs-v3-preview.elastic.dev/syntax)
Every directive and role the toolchain understands.
- [Browse the syntax guide](https://docs-v3-preview.elastic.dev/syntax)
- [Hub pages](https://docs-v3-preview.elastic.dev/syntax/hub-pages)

### Documentation this toolchain builds
The published Elastic documentation, linked with cross-repository links.

#### Elasticsearch
Search and analytics documentation.
- [Search solution](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/solutions/search)
- [Manage data](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/manage-data)

#### Observability
Logs, metrics, traces, and alerting documentation.
- [Observability solution](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/solutions/observability)
- [Explore and analyze](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/explore-analyze)

#### Security
SIEM, endpoint, and detection documentation.
- [Security solution](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/solutions/security)
- [Deploy and manage](https://docs-v3-preview.elastic.dev/elastic/docs-content/tree/main/deploy-manage)

## Explore docs-builder
Find what you need, organized by task, from authoring and building to publishing and operating.

### Authoring

#### Syntax
- [Directives](https://docs-v3-preview.elastic.dev/syntax/directives)
- [Hub pages](https://docs-v3-preview.elastic.dev/syntax/hub-pages)
- [Hero](https://docs-v3-preview.elastic.dev/syntax/hero)
Card directives:
- [Card group](https://docs-v3-preview.elastic.dev/syntax/card-group)
- [Link card](https://docs-v3-preview.elastic.dev/syntax/link-card)
- [Explore](https://docs-v3-preview.elastic.dev/syntax/explore)
- [Page card](https://docs-v3-preview.elastic.dev/syntax/page-card)

#### Getting started
- [Installation](https://docs-v3-preview.elastic.dev/getting-started/installation)
- [Writing content](https://docs-v3-preview.elastic.dev/getting-started/writing-content)
- [Pages and links](https://docs-v3-preview.elastic.dev/getting-started/pages-and-links)

#### Formatting
- [Code blocks](https://docs-v3-preview.elastic.dev/syntax/code)
- [Tables](https://docs-v3-preview.elastic.dev/syntax/tables)
- [Lists](https://docs-v3-preview.elastic.dev/syntax/lists)
- [Admonitions](https://docs-v3-preview.elastic.dev/syntax/admonitions)

#### Page metadata
- [Frontmatter](https://docs-v3-preview.elastic.dev/syntax/frontmatter)
- [Links](https://docs-v3-preview.elastic.dev/syntax/links)
- [Substitutions](https://docs-v3-preview.elastic.dev/syntax/substitutions)

### Builds and configuration

#### Build types
- [Isolated builds](https://docs-v3-preview.elastic.dev/documentation/isolated/configure)
- [Assembler](https://docs-v3-preview.elastic.dev/documentation/assembler/configure)
- [Codex](https://docs-v3-preview.elastic.dev/documentation/codex)

#### Catalog
- [Products](https://docs-v3-preview.elastic.dev/documentation/catalog/products)
- [Versions](https://docs-v3-preview.elastic.dev/documentation/catalog/versions)
Also see:
- [Synonyms](https://docs-v3-preview.elastic.dev/documentation/catalog/synonyms)
- [Legacy URLs](https://docs-v3-preview.elastic.dev/documentation/catalog/legacy-url-mappings)

### Structured data and operations

#### Exporters
- [Overview](https://docs-v3-preview.elastic.dev/data/exporters)
- [LLM markdown](https://docs-v3-preview.elastic.dev/data/exporters/llm)
- [Plain text](https://docs-v3-preview.elastic.dev/data/exporters/plain-text)

#### Operations
- [Distributed builds](https://docs-v3-preview.elastic.dev/documentation/distributed-builds)
- [Infrastructure](https://docs-v3-preview.elastic.dev/documentation/assembler/infrastructure)