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

# Blocks

> Every Doc block type: heading, paragraph, code, formula, list, image, divider, spacer, note, table, chart, and group

Every block is a tagged object with a `type` field. You pass blocks to `page.content`, and
each block's optional `style` overrides its role style for that one block.

Here is the full union once, then a section per block below.

```ts theme={null}
type Block =
  | { type: "heading"; text: InlineContent; level?: 1 | 2 | 3 | 4 | 5 | 6; style?: StyleProperties }
  | { type: "paragraph"; text: InlineContent; style?: StyleProperties }
  | { type: "code"; text: string; language?: string; style?: StyleProperties }
  | { type: "formula"; text: string; style?: StyleProperties }
  | { type: "list"; items: InlineContent[]; ordered?: boolean; style?: StyleProperties }
  | { type: "image"; src: string; width?: number; height?: number; style?: StyleProperties }
  | { type: "divider"; style?: StyleProperties }
  | { type: "spacer"; size?: number }
  | { type: "note"; text: InlineContent; title?: InlineContent; variant?: "info" | "warn" | "success" | "muted"; style?: StyleProperties }
  | { type: "table"; rows: TableRow[]; headers?: TableRow; columns?: number | number[]; style?: StyleProperties }
  | { type: "chart"; chart: ChartKind; data: ChartData; height?: number; title?: string; legend?: boolean; style?: StyleProperties }
  | { type: "group"; children: Block[]; gap?: number; style?: StyleProperties };
```

## heading

A title with a `level` from 1 to 6. `text` accepts [inline content](/packages/pdf/doc/inline).

```ts theme={null}
{ type: "heading", text: "Quarterly Report", level: 1 }
```

## paragraph

A run of body text. `text` accepts inline content.

```ts theme={null}
{ type: "paragraph", text: "Revenue grew across every region this quarter." }
```

## code

A tinted monospace block. `language` is a label only and does not enable syntax
highlighting.

```ts theme={null}
{ type: "code", language: "ts", text: "const total = items.reduce((a, b) => a + b, 0);" }
```

## formula

LaTeX, typeset to vector paths. See [Formulas](/packages/pdf/doc/formulas) for math fonts.

```ts theme={null}
{ type: "formula", text: "\\int_0^\\infty e^{-x^2}\\,dx = \\frac{\\sqrt{\\pi}}{2}" }
```

## list

An ordered or unordered list. Each item is inline content.

```ts theme={null}
{ type: "list", ordered: true, items: ["First", "Second", "Third"] }
```

## image

References a file path or a name registered with `load_image`. `width` and `height` size it.

```ts theme={null}
{ type: "image", src: "logo.png", width: 120 }
```

## divider

A horizontal rule.

```ts theme={null}
{ type: "divider" }
```

## spacer

Vertical space sized by `size`.

```ts theme={null}
{ type: "spacer", size: 24 }
```

## note

A callout box. `variant` is one of `info`, `warn`, `success`, or `muted`. Both `text` and
`title` accept inline content.

```ts theme={null}
{ type: "note", variant: "info", title: "Note", text: "Figures are unaudited." }
```

## table

Rows of cells with optional headers and column sizing. See
[Tables](/packages/pdf/doc/tables) for cell shapes and column widths.

```ts theme={null}
{
  type: "table",
  headers: ["Metric", "Q3", "Q4"],
  rows: [
    ["Revenue", "1.2M", "1.6M"],
    ["Margin", "18%", "24%"],
  ],
}
```

## chart

A native vector chart. `chart` is the chart kind and `data` holds the values. See
[Charts](/packages/pdf/doc/charts) for chart kinds and data shapes.

```ts theme={null}
{
  type: "chart",
  chart: "bar",
  title: "Revenue by quarter",
  legend: true,
  height: 220,
  data: {
    labels: ["Q1", "Q2", "Q3", "Q4"],
    series: [{ name: "2025", values: [16, 22, 20, 28] }],
  },
}
```

## group

Keeps its `children` together across page breaks, so a heading and its paragraph never
split. `gap` adds space between children.

```ts theme={null}
{
  type: "group",
  gap: 6,
  children: [
    { type: "heading", text: "Summary", level: 2 },
    { type: "paragraph", text: "This section stays together." },
  ],
}
```

<Tip>
  Anywhere a block takes `text`, it accepts inline content: a string, one inline node, or an
  array mixing both. See [Inline content](/packages/pdf/doc/inline).
</Tip>