[Release]: v5.0.0-rc.2

[sy-records]

✨ Features

• support config helper multi keys if supported (feat: support config helper multi keys if supported #2571)
• support extract content between fragment markers from Markdown (feat: support extract content between fragment markers from Markdown #2582)
• GitHub style callouts (feat: GitHub style callouts #2487)

🐛 Bug Fixes

• exclude app-name-link from sidebar text overflow styling (fix: exclude app-name-link from sidebar text overflow styling #2564)
• enhance focus handling by adding smooth scroll to content area (fix: enhance focus handling by adding smooth scroll to content area #2569)
• handle hash navigation to prevent duplicate callbacks (fix: handle hash navigation to prevent duplicate callbacks #2575)
• remove block display from anchor links to prevent layout issues (fix: remove block display from anchor links to prevent layout issues #2576)
• escape HTML in search keywords and trim sidebar id (fix: escape HTML in search keywords and trim sidebar id #2586)
• enhance focus handling (fix: enhance focus handling #2595)
• remove ignored headings and children in sidebar (fix(sidebar): remove ignored headings and children #2580)
• update relative link handling (fix: update relative link handling #2579)
• improve slug generation (fix: improve slug generation #2581)
• normalize slugs to NFC and remove emoji variation selector (fix: normalize slugs to NFC and remove emoji variation selector #2597)
• do not cut off bottom portion of text (do not cut off bottom portion of text #2568)

♻️ Refactor

• optimize toggleSidebar trigger conditions (refactor: optimize toggleSidebar trigger conditions #2557)
• simplify auto header insertion logic (refactor: simplify auto header insertion logic #2578)

🛠 Chore

• bump rollup-plugin-import-css from 3.5.0 to 4.0.1 (chore: bump rollup-plugin-import-css from 3.5.0 to 4.0.1 #2554)
• bump lint-staged from 15.2.7 to 16.1.0 (chore: bump lint-staged from 15.2.7 to 16.1.0 #2553)
• bump stefanzweifel/git-auto-commit-action from 5 to 6 (chore: bump stefanzweifel/git-auto-commit-action from 5 to 6 #2562)
• bump marked from 15.0.3 to 16.0.0 (chore: bump marked from 15.0.3 to 16.0.0 #2559)
• bump form-data from 4.0.0 to 4.0.4 (chore: bump form-data from 4.0.0 to 4.0.4 #2572)
• remove themes directory from package.json files list (chore: remove themes directory from package.json files list #2574)
• bump jest from 29.7.0 to 30.0.3 (chore: bump jest from 29.7.0 to 30.0.3 #2561)
• update pull requests and issues template (chore: update pull requests and issues template #2584)
• bump cross-env from 7.0.3 to 10.0.0 (chore: bump cross-env from 7.0.3 to 10.0.0 #2589)
• bump jest-environment-jsdom from 29.7.0 to 30.0.5 (chore: bump jest-environment-jsdom from 29.7.0 to 30.0.5 #2590)
• update launch configuration (chore: update launch configuration #2587)

📖 Docs

• update sidebar link formatting (docs: update sidebar link formatting #2577)
• Improve Quick start instructions (docs: Improve Quick start instructions #1466)
• Included relevant CSS vars to theme docs (docs: Included relevant CSS vars to theme docs. #2592)
• remove loading dialog section from quickstart guide (docs: remove loading dialog section from quickstart guide #2585)

🎨 Style

• CSS updates for coverpage, iframe dark mode transparency and codeblock contrast (style: CSS updates for coverpage, iframe dark mode transparency and codeblock contast #2593)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docsify-preview	Ready	Preview	Comment	Sep 2, 2025 8:40am

[paulhibbitts]

This is awesome to see, thanks so much @sy-records ! I will start testing this PR Preview build my Docsify-This v2 Preview site (https://preview-v2.docsify-this.net/) and with my Docsify Starter Kits using the new core Docsify theme:

• https://hibbitts-design.github.io/preview-docsify-open-course-starter-kit-v2-docsify-v5-theme
• https://hibbitts-design.github.io/preview-docsify-open-publishing-starter-kit-v2-docsify-v5-theme
• https://hibbitts-design.github.io/demo-docsify-open-blog-starter-kit-v2-docsify-v5-theme

I will report back any issues I see!

[paulhibbitts]

I've done further testing, including a range of content types and dark mode, and this RC-2 continues to look very good. Special shout-out and appreciation to @jhildenbiddle for his excellent work on the new v5 core theme ❤️

[paulhibbitts]

Looks like the zh docs are missing the embedded CSS vars docs I added a while back. Could you please update them too @sy-records ?

Here is the English docs Markdown for convenience:

### Common

Below are the most commonly modified theme properties. [Advanced](#advanced) theme properties are also available for use but typically do not need to be modified.

[\_vars.css](https://raw.githubusercontent.com/docsifyjs/docsify/refs/heads/develop/src/themes/shared/_vars.css ':include')

### Advanced

Advanced theme properties are also available for use but typically do not need to be modified. Values derived from [common](#common) theme properties but can be set explicitly if preferred.

[\_vars-advanced.css](https://raw.githubusercontent.com/docsifyjs/docsify/refs/heads/develop/src/themes/shared/_vars-advanced.css ':include')

[sy-records]

I have translated it, but it hasn't been merged yet.

see docsifyjs/docs-zh#62

[paulhibbitts]

Oh that is excellent, thank you @sy-records !

[paulhibbitts]

I've now tested this PR preview with multiple Docsify instances and also via Docsify-This v2 and it continues to look solid from my perspective👍🏼

PS - With this RC looking so good I think it's also ready for me to start spreading the word more on my Mastodon, Bluesky and Linkedin accounts! This will include a fresh round of preview releases of my Docsify Starter Kits and Docsify-This v2 all using this RC-2.