Summary

I want to be able to reference a heading in a different file. In Github I would do this:

[Guide Part 2](/path/to/guide.md#part-2)

Full explanation

Let's say I have the file path/to/guide.md which looks like:

# Guide

## Part 1

## Part 2

Linking to that doc via an absolute path (from a different file) works well:

[Guide](/path/to/guide)

however, trying to link to a heading in that doc doesn't work, it gets resolved as an external reference:

<!-- None of these work: -->
[Guide](/path/to/guide#part-2)
[Guide](/path/to/guide.md#part-2)

It does happen to work if you use .html and get the relative path right (but it's still resolved as an external link).

[Guide](../../path/to/guide.html#part-2)