docs: Adds instructions to upgrade custom plugins to v5

[julienbusset]

Summary

Adds instructions in documentation to replace the toggleClass function in custom plugins, because this function doesn't exist anymore in v5. Instructions written in the "Upgrading" / "v4 to v5" section.
Is important because the toggleClass removal broke some plugins (like docsify-dark-switch).

Related issue, if any:

None, because if an issue should be declared, then it must be declared in plugin's repo.

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, renaming)
• Refactoring (no functional changes, no api changes)
• Build related changes
• Documentation content changes
• Other (please describe):

For any code change,

• Related documentation has been updated, if needed
• Related tests have been added or updated, if needed

Does this PR introduce a breaking change?

• Yes
• No

Tested in the following browsers:

• Chrome
• Firefox
• Safari
• Edge

[vercel]

@julienbusset is attempting to deploy a commit to the Docsify Team on Vercel.

A member of the Team first needs to authorize it.

[julienbusset]

@sy-records , you may be interested, aren't you?

[paulhibbitts]

Thanks very much for the PR @julienbusset !

In terms of placement, it is really not a "Step 5" item - at least for most readers of the guide. I would suggest making it more of a note for plugin developers, perhaps something more along these lines:

### 4. Update Plugin URLs

**Search Plugin:**

```html
<!-- v4 -->
<script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/plugins/search.js"></script>
<!-- OR non-versioned: -->
<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.js"></script>

<!-- v5 -->
<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/plugins/search.min.js"></script>

Zoom Plugin:

<!-- v4 -->
<script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/plugins/zoom-image.min.js"></script>
<!-- OR non-versioned: -->
<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/zoom-image.min.js"></script>

<!-- v5 -->
<script src="//cdn.jsdelivr.net/npm/docsify@5/dist/plugins/zoom-image.min.js"></script>

Note: If you're using additional Docsify plugins (such as emoji, external-script, front-matter, etc.), you'll need to update those URLs as well following the same pattern:

• Change /lib/plugins/ to /dist/plugins/
• Update version from @4 (or non-versioned) to @5
• Example: //cdn.jsdelivr.net/npm/docsify/lib/plugins/emoji.min.js becomes //cdn.jsdelivr.net/npm/docsify@5/dist/plugins/emoji.min.js

Plugin Authors: If you've written a custom plugin that uses window.Docsify.dom.toggleClass, this helper has been removed in v5. Replace it with the native Element.classList API:

The toggleClass function has been removed as it can be replaced effectively by the JavaScript native Element property classList. Therefore, you must make the replacement in your plugin if you used it.

Examples:

// v4
window.Docsify.dom.toggleClass(element, 'className');

// v5
element.classList.toggle('className');

// v4
window.Docsify.dom.toggleClass(element, 'action', 'className');

// v5
element.classList.action('className');

// v4
window.Docsify.dom.toggleClass(element, isDark ? 'add' : 'remove', 'dark');

// v5
element.classList[isDark ? 'add' : 'remove']('dark');

Key Differences Summary

[julienbusset]

Thanks @paulhibbitts , I took your relevant remark into account + removed duplicated content between your proposal and mine. Please take a look at it.
And thanks @sy-records for your benevolent administration :) I'm not fully familiar with the conventions here ^^'

[paulhibbitts]

Thanks for making those updates @julienbusset! LGTM.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docsify-preview	Ready	Preview	Aug 17, 2026 3:02am

[sy-records]

Suggested change

	**Plugin Authors:** If you've written a custom plugin that uses `window.Docsify.dom.toggleClass`, this helper has been removed in v5. Replace it with the native `Element.classList` API.
	#### Plugin Authors
	If you've written a custom plugin that uses `window.Docsify.dom.toggleClass`, this helper has been removed in v5. Replace it with the native `Element.classList` API.

[julienbusset]

Hmmm... I hope I didn't make a mistake by applying @sy-records 's change...
It also says that the branch needs a rebase on the base branch: does it? May I rebase. I need your lights.

[sy-records]

Lint CI requires fixes