# docusaurus | Meta | Knowledge Base | Instagit Easy to maintain open source documentation websites. GitHub Stars: 64k Repository: https://github.com/facebook/docusaurus --- ## Articles ### [How to Create Custom Pages in Docusaurus Beyond Docs and Blog](/facebook/docusaurus/how-to-create-custom-pages-docusaurus-beyond-docs-blog) Learn to create custom pages in Docusaurus beyond docs and blog. Add Markdown, MDX, or React files to src/pages for unique site content and routes. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Manage Code Highlighting and Syntax Highlighting in Docusaurus](/facebook/docusaurus/how-to-manage-code-highlighting-syntax-highlighting-docusaurus) Master Docusaurus code highlighting by configuring Prism in docusaurus.config.js. Learn to manage syntax highlighting effectively for your documentation site. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Configure the baseUrl Path in Docusaurus: Complete Guide to Sub-Path Hosting](/facebook/docusaurus/how-to-configure-baseurl-path-docusaurus) Easily configure your Docusaurus baseUrl path for sub-path hosting. Learn to set baseUrl in docusaurus.config.ts and use environment variables for seamless deployment. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Deploy a Docusaurus Site to Vercel or Netlify: A Complete Guide](/facebook/docusaurus/how-to-deploy-docusaurus-site-vercel-netlify) Deploy your Docusaurus site to Vercel or Netlify with ease. Follow this complete guide to import your Git repo, set the build command, and specify the output directory for a seamless deployment. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Enable Mermaid Diagram Support in Docusaurus: A Complete Configuration Guide](/facebook/docusaurus/how-to-enable-diagram-support-mermaid-docusaurus) Easily enable Mermaid diagram support in Docusaurus. Follow our complete guide to configure mermaid true and add the Docusaurus mermaid plugin for stunning visual documentation. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Add Live Code Blocks in Docusaurus: Complete Guide to the theme-live-codeblock Plugin](/facebook/docusaurus/how-to-add-live-code-blocks-docusaurus-live-codeblock-plugin) Learn to add live code blocks in Docusaurus with the theme live codeblock plugin. Follow our easy guide to integrate interactive code examples into your documentation. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Use Docusaurus with TypeScript for Development](/facebook/docusaurus/how-to-use-docusaurus-typescript-development) Learn to use Docusaurus with TypeScript for development. Write site configs in TS for compile-time safety and great autocompletion with typed APIs from @docusaurus/types. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Configure Sitemap Generation for Docusaurus Sites: Complete Guide](/facebook/docusaurus/how-to-configure-sitemap-generation-docusaurus-sites) Easily configure sitemap generation for your Docusaurus site using the built-in plugin. Ensure your content is discoverable with this complete guide. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Create and Manage Blog Posts in Docusaurus: The Complete Guide](/facebook/docusaurus/how-to-create-manage-blog-posts-docusaurus) Learn how to create and manage blog posts in Docusaurus. This guide covers the blogging engine, Markdown files, and automatic generation of lists, tags, authors, and RSS feeds. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Migrate from Docusaurus v2 to v3: Complete Upgrade Guide](/facebook/docusaurus/how-to-migrate-docusaurus-v2-v3) Upgrade to Docusaurus v3 with our comprehensive guide. Learn to update packages, restructure config, and replace plugins for a smooth migration. Get started now! - Tags: migration-guide - Published: 2026-03-04 ### [How to Use Docusaurus Preset Configurations: Complete Guide with Examples](/facebook/docusaurus/what-are-docusaurus-preset-configurations-how-to-use) Learn how to use Docusaurus preset configurations. Simplify your setup by bundling plugins, themes, and options for a complete documentation site with one reference. Get the complete guide. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Configure Google Analytics and GTag in Docusaurus: Complete Setup Guide](/facebook/docusaurus/how-to-configure-google-analytics-gtag-docusaurus) Learn how to configure Google Analytics and GTag in Docusaurus with our easy setup guide. Implement GA4 or Universal Analytics tracking for your Docusaurus site. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Use the Docusaurus Debug Plugin to Diagnose Build Issues](/facebook/docusaurus/how-to-use-docusaurus-debug-plugin-build-issues) Troubleshoot Docusaurus build issues with the debug plugin. Inspect configuration, routes, content, and global data at __docusaurus/debug for faster problem-solving. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Create Custom CSS Themes and Styling in Docusaurus: Complete Guide](/facebook/docusaurus/how-to-create-custom-css-themes-styling-docusaurus) Learn to create custom CSS themes and styling in Docusaurus. Customize global styles with customCss or use .module.css files for scoped component styling. Enhance your Docusaurus site. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Optimize Docusaurus Build Performance and Bundle Size](/facebook/docusaurus/how-to-optimize-docusaurus-build-performance-bundle-size) Optimize Docusaurus build performance and bundle size with Rspack and SWC. Reduce build times up to 3x and significantly shrink bundles. Learn how to implement these powerful optimizations now. - Tags: performance - Published: 2026-03-04 ### [How to Handle Client-Side Redirects in Docusaurus: A Complete Guide](/facebook/docusaurus/how-to-handle-client-side-redirects-docusaurus) Master Docusaurus client-side redirects with `@docusaurus/plugin-client-redirects` for seamless URL forwarding using meta-refresh and JavaScript. Enhance user experience now. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Set Up PWA Functionality with the Docusaurus PWA Plugin: Complete Implementation Guide](/facebook/docusaurus/how-to-set-up-pwa-functionality-docusaurus-pwa-plugin) Easily add PWA functionality to your Docusaurus site. Learn to implement offline mode and enhance user experience with the `@docusaurus/plugin-pwa` package. Get started today! - Tags: how-to-guide - Published: 2026-03-04 ### [How to Configure Search Functionality with Algolia in Docusaurus](/facebook/docusaurus/how-to-configure-search-functionality-algolia-docusaurus) Easily configure Algolia search in Docusaurus. Add the algolia object to themeConfig in docusaurus.config.js with your App ID, API key, and index name for powerful search. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Add Custom MDX Components to Docusaurus Pages](/facebook/docusaurus/how-to-add-custom-mdx-components-docusaurus-pages) Learn how to add custom MDX components to Docusaurus. Easily integrate custom React components globally into your Docusaurus site by modifying MDXComponents.tsx. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Customize a Docusaurus Theme Using Swizzling: The Complete Guide](/facebook/docusaurus/how-to-customize-docusaurus-theme-using-swizzling) Learn to customize Docusaurus themes with swizzling. Use the CLI to copy and override default React components in your site src theme folder for easy upgrades. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Set Up Internationalization (i18n) for Docusaurus Sites](/facebook/docusaurus/how-to-set-up-internationalization-i18n-docusaurus-sites) Easily set up internationalization i18n for Docusaurus sites. Configure your site for multiple languages and serve multilingual content efficiently. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Implement Versioning for Docusaurus Documentation: A Complete Guide](/facebook/docusaurus/how-to-implement-versioning-docusaurus-documentation) Master Docusaurus versioning to create immutable documentation snapshots. Freeze released versions and manage ongoing development seamlessly with this complete guide. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Configure Docusaurus Bundler (Webpack/Rspack) for Optimal Performance](/facebook/docusaurus/how-to-configure-docusaurus-bundler-webpack-rspack-optimal-performance) Unlock Docusaurus bundler performance with this guide. Learn to configure Webpack or Rspack using docusaurus.config.js and environment variables for faster builds and optimal site speed. - Tags: performance - Published: 2026-03-04 ### [How to Create a Custom Docusaurus Plugin from Scratch](/facebook/docusaurus/how-to-create-custom-docusaurus-plugin-scratch) Learn to create a custom Docusaurus plugin from scratch. Extend Docusaurus site generation using lifecycle hooks and JavaScript. - Tags: how-to-guide - Published: 2026-03-04