[Release]: v5.0.0-rc.2 #2598

sy-records · 2025-09-02T08:40:09Z

✨ 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)

…2569)

* update: support config helper multi keys --------- Co-authored-by: Luffy <lufei@docsifyjs.org>

…2576)

Co-authored-by: Luffy <lufei@docsifyjs.org>

Bumps [jest](https://github.com/jestjs/jest/tree/HEAD/packages/jest) from 29.7.0 to 30.0.3. - [Release notes](https://github.com/jestjs/jest/releases) - [Changelog](https://github.com/jestjs/jest/blob/main/CHANGELOG.md) - [Commits](https://github.com/jestjs/jest/commits/v30.0.3/packages/jest) --- updated-dependencies: - dependency-name: jest dependency-version: 30.0.3 dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Koy Zhuang <koy@ko8e24.top>

Co-authored-by: Luffy <lufei@docsifyjs.org>

Bumps [cross-env](https://github.com/kentcdodds/cross-env) from 7.0.3 to 10.0.0. - [Release notes](https://github.com/kentcdodds/cross-env/releases) - [Changelog](https://github.com/kentcdodds/cross-env/blob/main/CHANGELOG.md) - [Commits](kentcdodds/cross-env@v7.0.3...v10.0.0) --- updated-dependencies: - dependency-name: cross-env dependency-version: 10.0.0 dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Koy Zhuang <koy@ko8e24.top>

Bumps [jest-environment-jsdom](https://github.com/jestjs/jest/tree/HEAD/packages/jest-environment-jsdom) from 29.7.0 to 30.0.5. - [Release notes](https://github.com/jestjs/jest/releases) - [Changelog](https://github.com/jestjs/jest/blob/main/CHANGELOG.md) - [Commits](https://github.com/jestjs/jest/commits/v30.0.5/packages/jest-environment-jsdom) --- updated-dependencies: - dependency-name: jest-environment-jsdom dependency-version: 30.0.5 dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Koy Zhuang <koy@ko8e24.top>

Co-authored-by: Luffy <52o@qq52o.cn>

…2582)

* fix: update relative link handling * fix: To have the relative path evaluated also if the link needs to be not compiled.

Co-authored-by: Koy Zhuang <koy@ko8e24.top> Co-authored-by: Luffy <52o@qq52o.cn>

vercel · 2025-09-02T08:40:15Z

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

Project	Deployment	Preview	Comments	Updated (UTC)
docsify-preview	Ready	Preview	Comment	Sep 5, 2025 4:20am

paulhibbitts · 2025-09-02T17:17:08Z

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:

I will report back any issues I see!

paulhibbitts · 2025-09-03T19:09:17Z

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 · 2025-09-04T15:04:40Z

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 · 2025-09-04T15:08:14Z

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

see docsifyjs/docs-zh#62

paulhibbitts · 2025-09-04T15:13:11Z

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.

The merge-base changed after approval.

sy-records · 2025-09-05T04:24:26Z

Sorry. I missed a commit, so I need to release an RC3.

dependabot bot and others added 30 commits June 2, 2025 15:49

chore: bump rollup-plugin-import-css from 3.5.0 to 4.0.1 (#2554)

08372d9

chore: bump lint-staged from 15.2.7 to 16.1.0 (#2553)

3d53203

refactor: optimize toggleSidebar trigger conditions (#2557)

71ac41e

chore: bump stefanzweifel/git-auto-commit-action from 5 to 6 (#2562)

0e1e0db

chore: bump marked from 15.0.3 to 16.0.0 (#2559)

96852f0

fix: exclude app-name-link from sidebar text overflow styling (#2564)

375c058

fix: enhance focus handling by adding smooth scroll to content area (#…

20d095b

…2569)

chore: bump form-data from 4.0.0 to 4.0.4 (#2572)

3709947

feat: support config helper multi keys if supported (#2571)

a2f734f

* update: support config helper multi keys --------- Co-authored-by: Luffy <lufei@docsifyjs.org>

chore: remove themes directory from package.json files list (#2574)

84ba468

fix: handle hash navigation to prevent duplicate callbacks (#2575)

72569de

fix: remove block display from anchor links to prevent layout issues (#…

6e45024

…2576)

fix: heading link overflow style (#2568)

be21637

Co-authored-by: Luffy <lufei@docsifyjs.org>

docs: update sidebar link formatting (#2577)

5a49729

chore: update pull requests and issues template (#2584)

77420df

docs: Improve Quick start instructions (#1466)

c9301b0

Co-authored-by: Luffy <lufei@docsifyjs.org>

refactor: simplify auto header insertion logic (#2578)

b468bcd

chore: update launch configuration (#2587)

be53467

docs: Included relevant CSS vars to theme docs. (#2592)

5448d93

Co-authored-by: Luffy <52o@qq52o.cn>

fix: escape HTML in search keywords (#2586)

743e9cb

docs: remove loading dialog section from quickstart guide (#2585)

4c9e111

style: force light mode for iframes in dark theme (#2593)

5ac5a86

feat: support extract content between fragment markers from Markdown (#…

32aa74e

…2582)

fix: enhance focus handling (#2595)

22ac7e8

fix(sidebar): remove ignored headings and children (#2580)

2a49bd0

fix: update relative link handling (#2579)

eeacfcc

* fix: update relative link handling * fix: To have the relative path evaluated also if the link needs to be not compiled.

fix: improve slug generation (#2581)

9bc58c9

jhildenbiddle and others added 2 commits September 1, 2025 12:53

feat: GitHub style callouts (#2487)

2e59b0f

Co-authored-by: Koy Zhuang <koy@ko8e24.top> Co-authored-by: Luffy <52o@qq52o.cn>

fix: normalize slugs to NFC and remove emoji variation selector (#2597)

5999f09

paulhibbitts requested review from jhildenbiddle, paulhibbitts and Koooooo-7 September 3, 2025 15:01

paulhibbitts previously approved these changes Sep 4, 2025

View reviewed changes

[release] 5.0.0-rc.2

400ecbc

vercel bot deployed to Production September 5, 2025 04:20 View deployment

sy-records closed this Sep 5, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

[Release]: v5.0.0-rc.2 #2598

[Release]: v5.0.0-rc.2 #2598

sy-records commented Sep 2, 2025

Uh oh!

vercel bot commented Sep 2, 2025 •

edited

Loading

Uh oh!

paulhibbitts commented Sep 2, 2025 •

edited

Loading

Uh oh!

paulhibbitts commented Sep 3, 2025

Uh oh!

paulhibbitts commented Sep 4, 2025

Uh oh!

sy-records commented Sep 4, 2025

Uh oh!

paulhibbitts commented Sep 4, 2025

Uh oh!

paulhibbitts left a comment •

edited

Loading

Uh oh!

sy-records commented Sep 5, 2025

Uh oh!

Uh oh!

Uh oh!

[Release]: v5.0.0-rc.2 #2598

[Release]: v5.0.0-rc.2 #2598

Conversation

sy-records commented Sep 2, 2025

✨ Features

🐛 Bug Fixes

♻️ Refactor

🛠 Chore

📖 Docs

🎨 Style

Uh oh!

vercel bot commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

paulhibbitts commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

paulhibbitts commented Sep 3, 2025

Uh oh!

paulhibbitts commented Sep 4, 2025

Uh oh!

sy-records commented Sep 4, 2025

Uh oh!

paulhibbitts commented Sep 4, 2025

Uh oh!

paulhibbitts left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sy-records commented Sep 5, 2025

Uh oh!

Uh oh!

vercel bot commented Sep 2, 2025 •

edited

Loading

paulhibbitts commented Sep 2, 2025 •

edited

Loading

paulhibbitts left a comment •

edited

Loading