ref

.ref id:{String} -> Node

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

Examples of referenceable nodes include:

  • Headings

      # Heading {#id}
  • Figures

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

      | Header | Header |
    |--------|--------|
    | Cell | Cell |
    {#id}
  • Code blocks

      ```python {#id}
    print("Hello, World!")
    ```
  • Custom numbered blocks

      .numbered {key} ref:{id}

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

.ref {id}

Return

a CrossReference to the target node

Parameters

id

the reference ID of the target node being referenced

Wiki page

cross-references