插件与主题

插件/主题是 Docusaurus 的核心扩展点：搜索、PWA、Tailwind、Google Analytics 等都可插件化接入。

官方常用插件

@docusaurus/plugin-content-docs：文档。
@docusaurus/plugin-content-blog：博客。
@docusaurus/plugin-content-pages：自定义页面。
@docusaurus/plugin-pwa：PWA 支持。
@docusaurus/plugin-google-gtag / gtm：分析埋点。

主题

默认 classic 主题开箱即用。
可自定义 Navbar/Footer/Color Mode，覆盖 src/theme 组件。
社区主题：如 Tailwind、shiki 高亮等。

配置示例

// docusaurus.config.js
plugins: [
  [
    '@docusaurus/plugin-pwa',
    { offlineModeActivationStrategies: ['appInstalled', 'queryString'] },
  ],
],
themes: [
  '@docusaurus/theme-live-codeblock',
],

小贴士

插件越多，构建与包体越大，按需启用。
对搜索：可用 Algolia DocSearch，或社区本地搜索插件。***

上一章节MDX 与组件在 Markdown 中使用 React 组件。