What is Avodado?

Avodado is an AI-first docs-as-code tool. Documentation is plain Markdown, and anything visual — a diagram, a table, a roadmap — is a block: a fenced code section with a type and a YAML body. Because every block has a strict schema, an AI agent can write your docs reliably — and avo check proves they're right.

docs/orders.md
─────────────
## Request flow

```sequence
id: seq-place-order
title: Place order
endpoint: { method: POST, path: /orders }
actors:
  - { id: Client, name: Client }
  - { id: API, name: Orders API }
messages:
  - { from: Client, to: API, label: POST /orders, kind: sync }
  - { from: API, to: Client, label: 201 Created, kind: response }
```

That block renders as a real sequence diagram. There are 87 block types for diagrams, charts, tables, roadmaps, API docs, and more.

The main flow

Three commands, then talk to your AI:

npm install -g avodado   # 1. install the CLI
avo init                 # 2. set up the project — this also installs the AI skill
avo studio               # 3. open Avodado Studio in your browser

avo init asks which AI tools you use and writes the authoring skill for them (.avodado/skill/SKILL.md plus the file your tool reads — CLAUDE.md, Cursor rules, Copilot instructions). From that moment your agent knows the block grammar and can write valid docs.

avo studio is where you watch it happen: a visual editor over your .md files. Keep it open, then tell your AI what you need:

Document our checkout flow in docs/checkout.md — a sequence diagram of the payment path, an ERD of the order tables, and a status table of the rollout. Run avo check and fix anything it reports.

The agent writes the file, and the Studio page updates the moment it saves — click any block to tweak it yourself. More prompt patterns in Author with AI.

How it fits together

1. Write. Normal Markdown, plus blocks for anything visual. Describe what you want and your agent writes the blocks — or write them yourself in Studio or any editor.
2. Check. avo check validates every block and every cross-reference, and tells you exactly what to fix. It fails CI on errors.
3. Publish. One command turns the same files into a styled website, a slide deck, or a PDF.

Your .md files are the single source of truth. The CLI, the studio, and AI agents all read and write the same files — nothing else holds state.

Start here

Want to see it first? Browse the block catalog or the live demo — a real site built with avo build.