ref + reference

Two thin reference-marker shortcodes. `ref` is number-only; `reference` supports both keys and numbers.

Updated 2026-08-23

On this page

Two reference-marker shortcodes besides cite. They exist to support different reference styles inside markdown.

ref#

Source: templates/shortcodes/ref.html

Number-only marker — for legacy / numbered reference styles.

…claimed by Sitchin{{ ref(num=12) }}.
ParamTypeRequiredDefaultWhat
numnumberno?Reference number; anchors to #ref-<num>.
titlestringno"Reference"Tooltip text.

Output:

<sup class="wiki-ref">
    <a href="#ref-12" class="wiki-ref__link" title="Reference">[12]</a>
</sup>

reference#

Source: templates/shortcodes/reference.html

Key-or-number marker. Use when references are identified by string keys (e.g. sitchin-1976) rather than numbers.

…claimed by Sitchin{{ reference(key="sitchin-1976") }}.
…claimed by Sitchin{{ reference(number=12) }}.
ParamTypeRequiredDefaultWhat
keystringyes (or number)""Reference key; anchors to #ref-<key>.
numbernumberyes (or key)""Reference number; anchors to #ref-<number>.
textstringnokey/numberVisible marker text.

Output:

<sup class="wiki-reference">
    <a href="#ref-sitchin-1976" class="wiki-reference__link" title="">[sitchin-1976]</a>
</sup>

Which one should I use?#

StyleUse
Inline citation (most common)cite — preferred default.
Numbered-list referencesref
Key-based / author-year referencesreference

Edit this page on GitHub