Nesting

A cell's body is ordinary block content. That sounds unremarkable and is the entire reason these two directives exist: an unknown directive never parses its body, so every construct written inside a grid used to be invisible to the index, the renderer and the diagram pipeline alike.

A diagram in a cell

The shape that motivated the directive — the sphinx-needs demo corpus draws a PlantUML diagram inside a .. grid-item::, beside the source that produced it. Neither the code block nor the diagram reached any later phase before the grid parsed its body:

.. uml::

   node A
   node B
   A --> B

Other constructs in a cell

A target written inside a cell registers like any other, so this one resolves:

A cell holding a hyperlink target, an admonition and a list.

Note

Admonitions nest as they do anywhere else.

A bullet list
inside a cell
beside a table:

Option	Takes
`:gutter:`	0 to 5
`:columns:`	1 to 12, or `auto`

A grid inside a grid

A cell may hold a whole grid of its own:

The outer cell.

An inner cell,

and its neighbour.