To link to another topic or external site inline, you use the xref element.

As a general best practice, people say to avoid inline links if possible, but if referring to another topic or page, it might seem odd not to include the link.

The topic title will automatically be used as the anchor text for the link.

   <xref href="sample.dita"/>

If you want to manually specify the anchor text, code it like this:

   <xref href="sample.dita">Sample</xref>

If you're linking to an external source, you need to add the scope and format attributes to your link:

   <xref href="" scope="external" outputclass="external" format="html"></xref>

Get new posts delivered straight to your inbox.

Subscriber count: 3,220