Automated multilingual documentation for Docusaurus

What gets translated

• ✓Markdown (.md) and MDX (.mdx) documentation pages
• ✓Sidebar configurations and category labels
• ✓Frontmatter metadata (title, description, tags, slug)
• ✓Preservation of code blocks, syntax highlighting, and variables
• ✓Admonitions, callouts, and custom React components
• ✓Docusaurus i18n directory structure (i18n/[locale]/...)
• ✓Automated sync CLI (npx lingvit-docusaurus sync)
• ✓Localized search indexes (Algolia / local search)

Setup guide

1. 1

   Install the plugin

   Add @lingvit/docusaurus as a dev dependency.

   npm install @lingvit/docusaurus --save-dev

2. 2

   Configure docusaurus.config.js

   Register the plugin and configure your target locales.

   module.exports = {
     // ...
     i18n: {
       defaultLocale: 'en',
       locales: ['en', 'fr', 'de', 'es'],
     },
     plugins: [
       ['@lingvit/docusaurus', { projectKey: process.env.LINGVIT_PROJECT_KEY }],
     ],
   };

3. 3

   Run sync CLI before build

   Synchronize translations with Lingvit in CI or local build scripts.

   npx lingvit-docusaurus sync