Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

References can resolve to an implicit heading ID in a different document #1785

Open
glaebhoerl opened this issue Jan 17, 2025 · 1 comment
Open
Labels
bug Something isn't working

Comments

@glaebhoerl
Copy link

(v1.3.20)

Description

If in first.md I have:

# Introduction

and in second.md I have

# Introduction
...
# Section
Link to [introduction][#introduction]

then that link takes me to the Introduction in first.md, rather than the one in second.md! (I suspect in general it's "whichever document comes first in the ToC".)

Proposed solution

Implicit heading references should only resolve within the same document.

Additional notes

I notice there's an MEP that seems to specify the same thing:

Implicit references are not available project wide, and are only accessible in the current document, as many documents follow similar structures (Abstract, Introduction, Methods, Summary).

@glaebhoerl glaebhoerl added the bug Something isn't working label Jan 17, 2025
@rowanc1
Copy link
Member

rowanc1 commented Jan 17, 2025

This is surprising and feels like a regression. It was absolutely designed the way you describe.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

2 participants