Add support for specifying cross references for a specific section or location in a topic

[danroth27]

With the DocFX cross reference support it looks like you can easily define links to different docs in your project, which is great!

We also need to be ability to define cross references to specific places in a doc, like a specific section or a specific label. In Sphinx we use the :ref:label-name`` syntax to define these references:

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.

We need something similar in DocFX. It would be great if there was even a shorthand for referencing a specific section heading without having to define an explicit label, which is something Sphinx does not have.

[chenkennt]

It's already supported. For a heading, you can reference it using its name:

# This is a heading

[link](#this-is-a-heading)

If you need anchor in other places, use HTML:

<a name="this-is-an-anchor"></a>

[link](#this-is-an-anchor)

[danroth27]

Right, but I was specifically referring to cross referencing a location in a separate doc. The :ref: syntax can point to any label in any doc in the set of docs being built.

[chenkennt]

You can also cross reference in DocFX, like this:

<xref:topic_id#anchor_name>

[danroth27]

Ah, that sounds like just what we need. I'll try it out, but it sounds like you guys can close this issue.

[chenkennt]

Currently doesn't work, need some fix.

[danroth27]

@shirhatti

[superyyrrzz]

Hi @danroth27 , <xref:topic_id#anchor_name> is now supported in DocFX prerelease version. You can try it.