v2.0.15

Highlights

🌙 themeConfig.darkMode supports default and forced values

You can now set the default or forced theme behavior directly via themeConfig.darkMode, instead of relying on window.RSPRESS_THEME. It accepts values like 'dark', 'light', 'auto', 'force-dark', and 'force-light'.

import { defineConfig } from '@rspress/core';

export default defineConfig({
  themeConfig: {
    darkMode: 'force-dark',
  },
});

🔗 Markdown anchor link validation

Rspress now validates internal heading hash links during builds. Enable markdown.link.checkAnchors to catch broken anchors in same-page, relative, and absolute Markdown/MDX links.

import { defineConfig } from '@rspress/core';

export default defineConfig({
  markdown: {
    link: {
      checkAnchors: true,
    },
  },
});

What's Changed

New Features 🎉

• feat(search): Allow excluding pages from default search via frontmatter by @elliotcourant in #3456
• feat(theme/darkMode): support themeConfig.darkMode set default values by @SoonIter in #3473
• feat(mdx/link): support markdown anchor checks by @SoonIter in #3443

Performance 🚀

• perf(ssg): avoid eager asset source reads by @SyMind in #3459

Bug Fixes 🐞

• fix(theme/Nav): render active language as non-link by @SoonIter in #3450
• fix(core): allow overriding printFileSize config by @SoonIter in #3451
• fix(auto-nav-sidebar): isolate global sidebar by version by @SoonIter in #3454
• fix(mdx/title): strip inline markdown in h1 e.g: "# __ReplaceElements" by @SoonIter in #3468
• fix(theme/inline-code-link): align link styles --rp-c-link and nav gap by @SoonIter in #3474

Refactor 🔨

• refactor(search): extract helper and add idle callback cleanup ♻️ by @sanjaiyan-dev in #3467
• refactor(theme): use useLayoutEffect in useNavTransparent for performance🛠️ by @sanjaiyan-dev in #3475

Document 📖

• docs: fix broken documentation links by @chenjiahan in #3449
• docs: mention dark mode CSS variable selectors by @SoonIter in #3453

Other Changes

• chore(deps): update dev-tools by @renovate[bot] in #3448
• chore(deps): update skills-package-manager@0.11.0 by @SoonIter in #3455
• chore(deps): update rstack by @renovate[bot] in #3458
• chore(deps): update all patch dependencies by @renovate[bot] in #3457
• chore(deps): update shiki to ^4.2.0 by @renovate[bot] in #3464
• chore(deps): update dependency remark-cjk-friendly to ^2.1.0 by @renovate[bot] in #3461
• chore(deps): update dependency remark-cjk-friendly-gfm-strikethrough to ^2.1.0 by @renovate[bot] in #3462
• chore(deps): update rstack (major) by @renovate[bot] in #3465
• chore(deps): update rstack by @renovate[bot] in #3460
• chore(deps): update all patch dependencies by @renovate[bot] in #3471
• chore(deps): update dependency remark-cjk-friendly to ^2.3.1 by @renovate[bot] in #3472
• Release v2.0.15 by @SoonIter in #3478

New Contributors

• @SyMind made their first contribution in #3459

Full Changelog: v2.0.14...v2.0.15