# figure

    .figure caption:{InlineMarkdownContent? = null} \
                ref:{String? = null} \
               body:{MarkdownContent}
    -> Node

Content copied to clipboard

Inserts content in a figure block, with an optional caption.

If either caption or ref is set, the figure will be numbered according to the `figures` numbering rule.

As a Figure primitive, this function can be used in `.extend` to affect all figures in the document, including standalone Markdown images (`![alt](url)`) that are automatically wrapped in a figure:

    .extend {figure} where:{ref: .ref::equals {logo}}
        .container border:{1px solid gray}
            .super

Content copied to clipboard

#### Return

the new Figure node

#### Parameters

caption

- Optional
- Likely named

optional inline caption of the figure

ref

- Optional

optional ID for cross-referencing via reference

body

- Likely a body argument

content of the figure