# ref

    .ref id:{String} -> Node

Content copied to clipboard

Creates a reference to a target node with a matching ID.

Examples of referenceable nodes include:

- Headings

        # Heading {#id}

  Content copied to clipboard

- Figures

        ![Alt](image.png "Caption"){#id}

  Content copied to clipboard

- Tables

        | Header | Header |
        |--------|--------|
        | Cell   | Cell   |
        {#id}

  Content copied to clipboard

- Code blocks

        ```python {#id}
        print("Hello, World!")
        ```

  Content copied to clipboard

- Custom numbered blocks

        .numbered {key} ref:{id}

  Content copied to clipboard

The reference is successfully resolved if the ID matches that of a referenceable node in the document:

    .ref {id}

Content copied to clipboard

#### Return

a CrossReference to the target node

#### Parameters

id

the reference ID of the target node being referenced

#### Wiki page

cross-references