How can I use pointed topic links using an "aliases:" GUID in the frontmatter?

[DennisPRD]

Hi everyone! This is my first post but I have been using Docsy markdown for a couple of years now for authoring our product documentation. In this time I haven't figured out a way to format a GUID alias that jumps directly to a heading (## or ###).

Works great jumping to the page itself using this format [Page Title Text](/0cc6e6fa-993b-4fg5-44df-88b09806z0jk/) but when I want to jump directly to a topic within a page, I have to currently use a text partial url to jump there e.g. [Adding trusted Sites](/installation/web-installation/configuration/intranet-access-only-config/#step-2-adding-browser-trusted-sites).

I've tried various permutations e.g. [Adding trusted Sites](/0cc6e6fa-993b-4fg5-44df-88b09806z0jk/#step-2-adding-browser-trusted-sites) but none I've tried work.

Is there some formatting that I haven't come across to achieve this or is it not currently possible? If it's not currently possible could we please add this as a new feature. We are trying to eliminate broken links entirely and this would be a great step forward in achieving this. Thanks.

[fekete-robert]

Try using the relref shortcode of hugo. That references the file, not the url, and appending anchors works. However, it doesn't check that the anchor exists on the page. (The file must exist, otherwise the build fails.)
So it would be something like: [Adding trusted Sites]({{< relref "/installation/web-installation/configuration/intranet-access-only-config/_index.md#step-2-adding-browser-trusted-sites" >}})