fix: GitHub changed markdown rendering for headings/anchors #3548
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is a rebase/re-submit of @MikeRalphson's exact commit from PR #3408 as he is not currently available to rebase it (the markdown checks were broken at that point on main- they should be fixed now).
Here is that PR's text:
Closes #3207 #3160 #3136 #3128 #3029 #3197 #3132
This PR mechanically corrects for the change made by GitHub to its markdown renderer which no longer honours the mixed markdown/html form:
### <a name="myAnchor"></a> My Anchor
(the use of
name
orid
makes no difference), and only links to the implicit anchor#my-anchor
now work.This PR affects the
main
branch, so published versions of the OAS only. If merged, follow-up PRs will be raised for in-flight-dev
branch versions.An example of the result of this PR can be previewed here. [Note: points to @handrews's fork because of the re-submit]