Docusaurus配置KaTeX全局宏不生效如何解决

你当前的rehype插件传参格式错误，globalGroup、macros等配置项从未被传递给rehype-katex插件，所有配置均不生效。
remark/rehype所属的unified插件生态有固定的传参规范：如果要给插件传入自定义配置，必须将「插件引用」和「配置对象」包裹在同一个数组单元中。你当前的写法是把配置对象当成了与katex平级的独立rehype插件，Docusaurus构建时会直接跳过这个无效配置项，KaTeX全程使用默认配置运行：每次渲染单个公式块都会生成独立的隔离作用域，既不会读取你预定义的宏集合，也不会开启跨块宏共享能力。

1. 调整rehypePlugins配置项的写法，将KaTeX的配置和插件本身绑定为同一个数组项，修正后的配置片段如下：

const macros = {
  "\\x": "x+1",
  // 带参数的宏按如下格式定义即可，#1对应第一个传入参数
  "\\plocation": "\\text{P}_\\text{location} = #1 \\text{mbar}"
};

/** @type {import('@docusaurus/types').Config} */
const config = {
  // ... 其余配置保持不变
  presets: [
    [
      'classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          // ... 其余配置保持不变
          remarkPlugins: [math],
          rehypePlugins: [
            [katex, {
              throwOnError: true,
              globalGroup: true,
              macros
            }]
          ],
        },
        // ... 其余配置保持不变
      }),
    ],
  ],
  // ... 其余配置保持不变
};

2. 保存配置后完全重启Docusaurus开发服务/构建进程，配置即可生效。

• 你在macros对象中预定义的所有宏，可以在任意文档的行内公式、块级公式中直接调用，无需重复定义。
• 开启globalGroup: true后，在单个公式块内通过\gdef定义的宏，也可以在同页面后续的所有公式块中正常调用，跨块宏共享能力正常工作。
• 局部公式内通过\def定义的非全局宏，依然会保持原有作用域隔离，不会污染全局命名空间。

内容的提问来源于stack exchange，提问作者Peter