dotnet / dotnet/docfx

[Feature Request] xref link doesn't work as an include link

Open
#8,712 0 comments 0 reactions 0 assignees View on GitHub
markdown
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

**Is your feature request related to a problem? Please describe.**
When attempting to use an xref in an [!INCLUDE] directive it doesn't work.

For example:

Doesn't work
```md
[!INCLUDE [Platforms](xref:GettingStarted.UsingWizard.Platforms)]
```

Works:

```md
[!INCLUDE [Platforms](using-wizard/platforms.md)]
```

**Describe the solution you'd like**
Enable using xref links in include links.

**Describe alternatives you've considered**
Using url instead, which is not very productive.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.