> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# markdown block

> A free-text markdown block rendered above, below, or beside the chat panel.

# `markdown` block

Renders a markdown string. Use it for extra explanation paragraphs around the chat — features, target audience framing, "how to get the best out of this assistant" tips.

For short notes the chat panel itself should display, prefer `public_details.instructions` instead — that one renders directly inside the chat header area.

## When to use it

* Long-form copy that would be awkward inside `instructions`.
* A welcome paragraph that complements (not duplicates) the [hero](/sections/page-layout/hero) block.
* Footer-style fine print sitting under the chat.
* A landing-page-style block above the chat for SEO / first-impression copy.

## Shape

```json theme={null}
{
  "id": "intro-1",
  "type": "markdown",
  "position": "above_chat",
  "body": "## What this agent does\n\nIt answers questions about our docs, status, and warranty…"
}
```

| Field      | Required | Type                                    | Notes                                                |
| ---------- | -------- | --------------------------------------- | ---------------------------------------------------- |
| `id`       | yes      | string                                  | Stable kebab-case slug, unique within `page_layout`. |
| `type`     | yes      | `"markdown"`                            | Fixed.                                               |
| `position` | no       | `above_chat` / `below_chat` / `sidebar` | Defaults to `above_chat`.                            |
| `body`     | no       | string                                  | Markdown source. Empty `body` renders nothing.       |

## Tips

* Markdown and fenced ` ` code blocks are supported. HTML is intentionally not allowed.
* For prominent imagery + CTA, use [hero](/sections/page-layout/hero) instead — `markdown` has no styling beyond paragraph text.