mkdocs-translations

Translates MkDocs documentation into a target language preserving folder structure and Markdown formatting.

1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/Gabeujin/workspace-init-mcp --skill mkdocs-translations-gabeujin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mkdocs-translations
Source: https://github.com/Gabeujin/workspace-init-mcp/tree/main/awesome/skills/mkdocs-translations
Command: npx skills add https://github.com/Gabeujin/workspace-init-mcp --skill mkdocs-translations-gabeujin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the translation of MkDocs documentation into multiple languages, ensuring your project's content is accessible globally.

Core Features & Use Cases

  • Multi-language Support: Translates documentation into user-specified languages.
  • Preserves Structure: Maintains original folder structure and Markdown formatting.
  • Automated Updates: Modifies MkDocs configuration for new locales.
  • Use Case: A software project needs its English documentation translated into Spanish, French, and German for its international user base. This Skill handles the entire translation process, including file creation and configuration updates.

Quick Start

Translate the documentation into Korean (ko).

Frequently Asked Questions about mkdocs-translations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate MkDocs documentation into multiple languages?

To translate MkDocs documentation, you specify a target language and the Skill translates the English content while preserving the original folder structure and Markdown formatting. It also updates the MkDocs configuration for internationalization automatically.

Does translating MkDocs files preserve the original folder structure and Markdown formatting?

Yes, translating MkDocs files preserves the original folder structure and Markdown formatting. The Skill ensures that both the main documentation and included files are accurately translated without breaking the existing project layout.

Can I automate MkDocs configuration updates for internationalization?

Yes, you can automate MkDocs configuration updates for internationalization using this Skill. It modifies the configuration files to support new locales, handling the setup required for multi-language documentation automatically.

What is the best way to handle technical translation for software documentation?

The best way to handle technical translation for software documentation is to use an automated Skill that requires accurate technical translation and adheres to specific output formats. This ensures your project content is accessible globally while maintaining technical precision.

Are included files updated when localizing MkDocs documentation?

Yes, included files are updated when localizing MkDocs documentation. The Skill handles the translation of both the main documentation files and any included files, ensuring the entire content base is translated into the specified target language.