mkdocs-translations

Translate MkDocs Markdown files into target locale folders while preserving structure.

Updated Mar 10, 2026

Search Tags:#documentation #markdown #localization #translation #i18n #mkdocs

Ready to run

npx skills add https://github.com/m00sp/m00agents --skill mkdocs-translations-m00sp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mkdocs-translations
Source: https://github.com/m00sp/m00agents/tree/main/skills/mkdocs-translations
Command: npx skills add https://github.com/m00sp/m00agents --skill mkdocs-translations-m00sp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps documentation teams translate large MkDocs documentation sets into additional languages while preserving structure, formatting, and configuration consistency.

Core Features & Use Cases

Documentation Translation Workflow: Translates Markdown files from source language folders into a specified target locale while maintaining file organization and formatting.
MkDocs Localization Updates: Updates include paths and MkDocs internationalization settings for newly added languages.
Use Case: A technical writer maintaining an English MkDocs site can use this Skill to create a complete Spanish documentation version with mirrored folders, translated content, and locale configuration.

Quick Start

Use the mkdocs-translations skill to translate my MkDocs English documentation into the target language locale I specify.

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 another language?▼

MkDocs localization involves translating Markdown files into a target locale folder while preserving formatting and file organization, then updating include paths and internationalization configuration to support the new language.

How do I update MkDocs configuration for a new language locale?▼

Updating MkDocs internationalization configuration requires modifying the settings to recognize the newly added language locale and adjusting include path references so they resolve correctly within the translated folder structure.

Can I translate Markdown files while preserving include references and formatting?▼

Yes, translating Markdown files while preserving include references and formatting is supported by applying consistent target locale handling across the documentation set, ensuring structural elements remain intact during the file-by-file translation execution.

What is the best way to manage multilingual technical writing workflows in MkDocs?▼

Managing multilingual technical writing workflows in MkDocs requires establishing mirrored locale folders for each language, translating content file-by-file, and applying consistent internationalization configuration updates to maintain structural parity across versions.

Does translating an MkDocs site into multiple locales require manual folder mirroring?▼

Translating an MkDocs site into multiple locales requires creating mirrored locale folders for each target language, executing file-by-file translation within those directories, and updating the internationalization configuration to recognize each new locale.