Charts and data blocks

A data block holds a small table of numbers and draws it as a chart or a table, inside the document — so the data and the picture of it live in one Markdown file, with nothing to regenerate.

How to reach it

Type /data in the editor. A picker offers five kinds: Bar chart, Stacked bar, Line chart, Area chart and Table. Pick one and a starter block appears with two example rows, ready to edit.

The trigger only fires at the start of a line or after a space, so a path like docs/data does not open it, and it is ignored inside a fenced code block.

Editing

The block has its own small form: change the title, edit a label or a value, add and remove rows or series, and switch the kind without retyping the data. The chart redraws as you type, and the document is what stores it — there is no separate data file to keep in step.

What it is in the file

A fenced block tagged data, holding YAML:

```data
type: bar
title: Articles per pillar
data:
  - label: Guides
    value: 8
  - label: Notes
    value: 3
```

That is the whole format. You can edit it by hand, and other Markdown tools show it as an ordinary code block rather than breaking — the chart itself is drawn by Context Raven.

The block is written back in a fixed shape, so opening a note and saving it without touching the block leaves the file byte for byte as it was.

Where it appears

In the editor, in reading mode, and on a shared link — the same chart in all three.

Limits

A block that is not valid — a YAML error, or a number where text belongs — is shown as a plain code block instead, so the text you wrote is never lost or silently rewritten.

One block holds up to 1000 points, 50 series, and for a table 5000 rows by 100 columns; a title can be 500 characters. These are the same caps the form enforces, so you cannot build a block the app would then refuse to read.

There is no importing from a file, no live query, and no formula — the numbers are the ones in the block.