Skip to content

Conversation

brc-dd
Copy link
Member

@brc-dd brc-dd commented Mar 8, 2025

BREAKING CHANGES:

  • --vp-header-anchor-symbol is removed.
  • The default permalink function of markdown-it-anchor is changed to linkAfterHeader. This will need updates in your custom themes.
  • To revert back to older permalink behavior, you can set markdown.anchor.permalink to legacy in your vitepress config. Or use some other one from markdown-it-anchor.

This brings the original proposed behavior of #2039, #2040 which wasn't introduced to avoid breaking changes.

fixes #2980
closes #2982

TODO:

  • update tests (needs changing selectors)
    • __tests__/e2e/markdown-extensions/markdown-extensions.test.ts
    • __tests__/e2e/local-search/local-search.test.ts
  • fix local search plugin (probably splitting logic broke)

BREAKING CHANGES:
- `--vp-header-anchor-symbol` is removed
- The default permalink function of markdown-it-anchor is changed to `linkAfterHeader`. This will need updates in your custom themes.

This brings the original proposed behavior of #2039, #2040 which wasn't introduced to avoid breaking changes.

fixes #2980
closes #2982
@brc-dd brc-dd marked this pull request as draft March 8, 2025 19:54
Copy link

pkg-pr-new bot commented Apr 19, 2025

npm i https://pkg.pr.new/vitepress@4609

commit: 350b6e3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

a11y: Headings are read verbosely by VoiceOver
1 participant