[Release]: v5.0.0

[sy-records]

Features

• Added pageTitleFormatter configuration (#2695)
• Improved indexing and embedded search (#2734)

Bug Fixes

• Enhanced the slugify function to handle Markdown links (#2697)
• Enhanced sidebar navigation link selection for decoded URLs (#2708)
• Implemented the normalize method in html5.js (#2712)
• Normalize language input and escape HTML (#2716)
• Escape HTML in image, link, and media components (#2718)
• Enhance embed token handling in paragraphs and table cells
• Exclude headings inside blockquotes from the sidebar table of contents (#2691)
• Improve cache handling and error recovery (#2744)
• Keep anchor links aligned after layout changes (#2731)
• Strip front matter from included Markdown files (#2752)
• Corrected grammar in the “Edit on GitHub” section of plugins.md

Maintenance

• Updated axios from 1.8.2 to 1.16.0
• Updated marked from 17.0.1 to 18.0.3
• Updated postcss from 8.4.39 to 8.5.14
• Updated cssnano from 7.0.4 to 8.0.2
• Updated Playwright to v1.60
• Updated shell-quote, form-data, handlebars, lodash, flatted, picomatch, qs, and follow-redirects
• Updated serialize-javascript, @rollup/plugin-babel, @babel/plugin-transform-modules-systemjs, postcss-nesting, @rollup/plugin-terser, and lint-staged
• Updated the release and changelog workflows and the release script
• Added and expanded tests for embedded content, anchor scrolling, search, sidebar rendering, and type consumption
• Added v5 upgrade documentation and updated the configuration and deployment documentation
• Removed the Matomo plugin documentation and updated the embedded website link
• Consolidated the changelog history by removing HISTORY.md in favor of CHANGELOG.md

---

Release Notes for v5.0.0

This release continues the v5 stabilization work from v5.0.0-rc.1 to v5.0.0-rc.4, together with the changes included in #2745. It focuses on rendering correctness, routing stability, search improvements, accessibility, security hardening, type support, documentation, and dependency maintenance.

Bug Fixes

• auto header config heading generation function (#2474)
• fix Carbon integration (#2387)
• ci: run test action for pull requests (#2445)
• correct loadSidebar=false render structure issue (#2470)
• improve dev mode hot reload and add sourcemaps (#2402)
• improve external link detection (#2093)
• fix cross-origin links in history router mode (#1967)
• fix dependabot.yml (a321e83)
• fix docsify-server-renderer dependency (#1915)
• fix IDs containing only numbers (#2021)
• fix genIndex error for search (#1933)
• fix Husky auto-install issue after upgrade (#2325)
• fix heading parsing error (#2526)
• prevent unnecessary initial IntersectionObserver callback execution (#2523)
• prevent unnecessary themeColor deprecation notice (#2403)
• search: clean Markdown elements from search contents (#2457)
• fix skip-to-content scroll behavior (#2401)
• synchronize the page title with the title config (#2478)
• upgrade debug from 4.3.3 to 4.3.4 (#1919)
• upgrade medium-zoom from 1.0.6 to 1.0.7 (#1934)
• upgrade medium-zoom from 1.0.7 to 1.0.8 (#1939)
• upgrade node-fetch from 2.6.8 to 2.6.9 (#1996)
• fix errors when aliases contain parameters (#1855)
• enhance focus handling (#2595)
• enhance focus handling by adding smooth scrolling to the content area (#2569)
• escape HTML in search keywords (#2586)
• exclude app-name-link from sidebar text overflow styling (#2564)
• handle hash navigation to prevent duplicate callbacks (#2575)
• fix heading link overflow styling (#2568)
• improve slug generation (#2581)
• normalize slugs to NFC and remove emoji variation selectors (#2597)
• remove block display from anchor links to prevent layout issues (#2576)
• sidebar: remove ignored headings and their children (#2580)
• update relative link handling (#2579)
• adjust IntersectionObserver threshold for sticky class toggling (#2637)
• enhance accessibility for the sidebar toggle button (#2604)
• improve word breaking for code blocks in Markdown (#2636)
• include h6 headings in heading element selection (#2649)
• strip HTML tags from config.name when setting the page title (#2690)
• fix typo (#2632)
• enhance slug generation for Markdown links (#2697)
• improve sidebar navigation link selection for decoded URLs (#2708)
• implement the normalize method in html5.js (#2712)
• normalize language input and escape HTML (#2716)
• escape HTML in image, link, and media components (#2718)
• enhance embed token handling in paragraphs and table cells (870881a)
• exclude headings inside blockquotes from the sidebar TOC (#2691)
• improve cache handling and error recovery (#2744)
• keep anchor links aligned after layout changes (#2731)
• strip front matter from included Markdown files (#2752)

Features

• add “Skip to main content” link and update navigation behavior (#2253)
• add Google Analytics gtag.js plugin (#1702)
• allow top navigation to receive keyboard focus (#2269)
• add keyboard bindings (#2279)
• search: use Dexie.js instead of localStorage (#2464)
• support dark mode for the zoom-image plugin (#2524)
• support Prism language dependency import validation (#2489)
• support relative paths with the target config (#1751)
• v5 style overhaul (#2469)
• add GitHub-style callouts (#2487)
• support multiple keys in config helpers (#2571)
• support extracting content between fragment markers from Markdown (#2582)
• add fallback default language support (#2607)
• enhance embed handling for table cells (#2606)
• support full-line fragment identifier ignores (#2626)
• output type definitions and allow new Docsify(opts) to accept options for ESM usage (#2392)
• add pageTitleFormatter config (#2695)
• improve indexing and embedded search (#2734)

Chore

• update dependencies including axios, marked, postcss, cssnano, playwright, shell-quote, form-data, handlebars, lodash, flatted, picomatch, qs, follow-redirects, serialize-javascript, @rollup/plugin-babel, @babel/plugin-transform-modules-systemjs, postcss-nesting, @rollup/plugin-terser, and lint-staged
• update the release and changelog workflows and release script
• add and expand tests for embedded content, anchor scrolling, search, sidebar rendering, and type consumption
• add v5 upgrade documentation and refresh configuration and deployment documentation
• correct grammar in the “Edit on GitHub” section of plugins.md (18b03e4)
• remove Matomo plugin documentation and update the embedded website link (#2696)
• consolidate changelog history by removing HISTORY.md in favor of CHANGELOG.md

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docsify-preview	Ready	Preview, Comment	Jul 8, 2026 3:17am