-
-
Notifications
You must be signed in to change notification settings - Fork 84
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
Something changed in how header anchors are named in the output HTML #229
Comments
GitHub doesn't use the html-pipeline project; please let me know if there's verbiage there that suggests otherwise. (They used to use it, but that hasn't been the case for some five years now.) Furthermore, I'm going to close this issue, not because I don't care, but because this seems to be something GitHub has changed on their end. I can't really control if they use this gem as a base and then add their own modification. Your best bet is probably http://github.com/support. |
GitHub has ~always prepended The Wayback machine shows the document tree for this document used to look like this back in 2021: It now looks like this: The case difference appears significant — it looks like they stopped lowercasing the existing Your options are likely:
|
Thank you for the clarification here. I will follow up with GitHub. |
We recently started noticing that links in the OpenAPI specification markdown document are broken when rendered on GitHub.
OAI/OpenAPI-Specification#3132
We are seeing reports like the following:
Apparently GitHub changed the way it treats anchors embedded in headlines, for example
This used to copy the anchor element verbatim to the HTTP output, and links such as Schema Object worked fine.
Now the anchor name is prefixed with user-content-, resulting in
and all links broken.
From my investigation, it appears that GitHub use the html-pipeline project, which uses this commonmarker project, which then uses comrak. It seems like it is comrak that is adding the user-content prefix to the header-ids. However, my Ruby/Rust skills are not nearly strong enough to figure out what changed and why links that were previously ok are now broken.
Any suggestions on how we might resolve this issue would be most appreciated. Thanks.
The text was updated successfully, but these errors were encountered: