> ## Documentation Index
> [HTML page](https://blode.md/docs)
> [Documentation index](https://blode.md/docs/llms.txt)
> Use the index to discover all available pages before exploring further.

# Introduction

Edda: Knowledge docs for agents. Git-native MDX. Publish on merge. The merge publishes the HTML and the Markdown agents fetch.

Knowledge docs for agents. Git-native MDX. Publish on merge. Write MDX in the repo, review it in the pull request, and the merge publishes the HTML plus the Markdown agents fetch. Navigation and branding live in a single `docs.json` file, and `edda push` deploys the same content from the CLI or CI.

> [!INFO]
> **For agents:** these docs are fully public: no authentication, no rate
>   limits, no signed URLs. Programmatic clients can fetch
>   [`/llms-full.txt`](https://docs.blode.md/llms-full.txt) for the complete
>   corpus, [`/llms.txt`](https://docs.blode.md/llms.txt) for the page index, or
>   append `.md` to any page URL for the raw markdown. Start with the index: every
>   `.md` page links back to it. See [Docs for
>   agents](/features/agent-readable-docs).

## How it works

  1. **Write MDX**

Create `.mdx` files with Markdown, JSX components, and frontmatter. Over 30
built-in components are available with no imports needed.
  1. **Configure**

Define your navigation and branding in a single `docs.json` file.
  1. **Deploy**

Run `edda push` from your terminal or CI pipeline. Your docs are live in
seconds.

## Features

  ### [30+ MDX components](/components/callout)

Callouts, tabs, steps, code groups, accordions, type tables, and more. No
imports needed.
  ### [One-command deploy](/deployment/push)

Push from your terminal or automate with GitHub Actions. Atomic deployments
with zero downtime.
  ### [Custom domains](/features/custom-domains)

Every project gets a `*.blode.md` subdomain. Add your own domain with DNS
configuration.
  ### [OpenAPI support](/features/openapi)

Drop in an OpenAPI spec and get auto-generated API reference pages with an
interactive playground.
  ### [Built-in search](/features/search)

Full-text search with Cmd+K. Auto-indexed from your content, no
configuration needed.
  ### [Docs for agents](/features/agent-readable-docs)

llms.txt, llms-full.txt, and a Markdown twin of every page, written by the
same deploy as the HTML. Sitemaps and robots.txt too.

## Next steps

  ### [Quickstart](/quickstart)

Go from zero to deployed docs in five minutes.
  ### [Components](/components/callout)

Browse all available MDX components.
  ### [CLI reference](/cli/overview)

See every command and option.