You can use ref URIs in admonitions (or any shortcodes) because they are inline and not subject to the issues noted in the admonition shortcode.
The ref URIs perform the same pattern matching as docs/reference but don't require the use of reference-style links and the destinations are ordinary (full) URLs that can include version substitution. Unlike docs/reference, the implementation doesn't use relref so you don't have to be careful with omitting trailing slashes and the links will follow redirects.
You can use
ref
URIs in admonitions (or any shortcodes) because they are inline and not subject to the issues noted in theadmonition
shortcode.The
ref
URIs perform the same pattern matching asdocs/reference
but don't require the use of reference-style links and the destinations are ordinary (full) URLs that can include version substitution. Unlikedocs/reference
, the implementation doesn't userelref
so you don't have to be careful with omitting trailing slashes and the links will follow redirects.Documentation: https://grafana.com/docs/writers-toolkit/write/links/#link-from-source-content-thats-used-in-multiple-projects
Signed-off-by: Jack Baldry jack.baldry@grafana.com