Hugo Ref Shortcode Quirks

Reference: https://gohugo.io/content-management/shortcodes/ Is the shortcode required?

When working with Markdown this shortcode is obsolete. Instead, to properly resolve Markdown link destinations, use the embedded link render hook or create your own.

The documentation that’s linked to seems to suggest that internal links will get rendered correctly if they’re created like this:

Test link [Halley's Fractals](/notes/generating-fractals-with-halleys-method)

Test link Halley’s Fractals

Generates the following HTML:

<p>
  Test link <a href="/notes/generating-fractals-with-halleys-method">Halley’s Fractals</a>
</p>