# Registry markdown

> The markdown dialect agents and people use to write Memrio pages, including instruction, fact, callout, and fields blocks.

Pages are stored as structured blocks. The editor writes them; agents write them through markdown that maps one-to-one onto those blocks. Standard markdown covers most of it; four directive fences add the registry-specific blocks.

## Standard markdown

- Headings: `#`, `##`, `###`
- Paragraphs, `- ` bullets, `1. ` numbered lists, `- [ ]` checklists
- `> ` quotes, fenced code blocks, `---` dividers

## Directive blocks

### instruction

A rule the reading agent must follow. Priority is `critical`, `high`, or `normal`. Instructions are what `browse` shows as “use when”, so make the first one describe when the page applies.

```md
:::instruction critical
Never promise a refund before checking the order date.
:::
```

### fact

A verified, citable statement. Agents are encouraged to quote facts verbatim.

```md
:::fact
Annual plans are pro-rated to the day.
:::
```

### callout

A highlighted note for humans and agents. Tone is `info`, `warning`, or `success`.

```md
:::callout warning
Refund exceptions require a manager approval code.
:::
```

### fields

Label / value pairs — owners, SLAs, contact points. One `Label: value` per line.

```md
:::fields
Owner: Billing team
Review cadence: 90 days
Escalation: #billing-escalations
:::
```

## A complete page

**Refund policy**

```md
:::instruction critical
Use this page whenever a customer asks about refunds, returns, or chargebacks.
:::

:::instruction high
Never promise a refund before checking the order date.
:::

## Policy

Customers may request a refund within 30 days of purchase.

:::fact
Annual plans are pro-rated to the day. Monthly plans have no partial refunds.
:::

## Exceptions

- Duplicate charges: refund in full, any time.
- Service outage over 24h: refund the affected month.

:::fields
Owner: Billing team
Review cadence: 90 days
:::
```

Source: https://memrio.ai/docs/registry-markdown