Hi Dojo,
I'm writing a contribution to DataMiner docs, but have some trouble figuring out some of the referencing in markdown. If I have a page with uid 'mypage' which has a heading '## My section', and want to reference to that specific section on a different page, how should that reference look like?
Hi Reinout,
To add a cross-reference to a specific header of a different page in the documentation, use the "xref:uid" syntax, followed by a hash and the header text, specified in the same way as for a link on the same page. For example:
[System components](xref:PageUid#section-two)
Ty Marieke, I’ve updated the answer to reflect your comment.
If, on the page containing the section you want to refer to, you enter “[](#”, you will automatically get a list of all internal anchors on that page. You can then copy the entire link to the other page. This way, you will avoid any spelling mistakes in the internal anchor.
However, once you’ve pasted the link in the other page, don’t forget to add the link to the page itself (“xref:pageUid”) in front of the anchor. You should then end up with a link like this: [My link](xref:myOtherPageUid#my-internal-anchor)
Note that in the part of the syntax after the #, no capitals, special characters, or spaces are allowed. Write everything in lowercase, leave out special characters, and use hyphens instead of spaces.