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="http://example.org" scope="external" outputclass="external" format="html">Example.org</xref>

Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers