mkdocs-static-i18n
MkDocs i18n plugin using static translation markdown files
Decision gist · record as of 2026-08-14
Yes, if you maintain MkDocs documentation and need multi-language support. The plugin is actively maintained, has no known vulnerabilities, installs with minimal friction, and uses a permissive MIT license. It's in use by hundreds of projects. The main caveat is that it requires Python 3.8 or later and assumes you're comfortable organizing localized content as static markdown files.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later and an existing MkDocs project.
- Low friction install as a pure Python wheel with a single runtime dependency on mkdocs.
- The project is actively maintained with a recent release and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.
last release 2026-02-20 (175 days) · last repo commit 2026-03-23 · 321 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 660,685 downloads/mo, #5,458 on PyPI
Alternatives
Verify before relying
pip install mkdocs-static-i18n
# In mkdocs.yml, add the plugin:
plugins:
- i18n
# Add localized markdown files:
# docs/index.md (default)
# docs/index.fr.md (French)
# docs/index.es.md (Spanish)- Whether the plugin supports right-to-left language layouts or only left-to-right content
- Performance characteristics when managing documentation with many language variants
- Whether localized asset serving works for all file types or has restrictions
What it is and what it does
mkdocs-static-i18n is a plugin for MkDocs that enables multi-language documentation by letting you add language-specific markdown files alongside your default documentation. Instead of maintaining separate documentation builds per language, you organize localized content using file suffixes (like `page.fr.md` for French) or folder structures, and the plugin automatically generates language-specific site variants during the build.
The plugin also handles localized images, media, and other assets using the same suffix or folder approach. It's designed for documentation teams that want to support multiple languages without complex translation workflows or separate build pipelines—you add localized files to your existing documentation structure, configure the plugin in mkdocs.yml, and it handles the rest.
Use it for
- Building multi-language documentation for open-source projects where contributors provide translations as markdown files
- Creating localized versions of technical documentation for software targeting international audiences
- Serving region-specific assets alongside language-specific content in a single MkDocs build
- Maintaining documentation in multiple languages without duplicating the entire site structure for each language variant
- Publishing API or product documentation that needs to reach users in different languages and regions
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you maintain MkDocs documentation and need multi-language support.
The plugin is actively maintained, has no known vulnerabilities, installs with minimal friction, and uses a permissive MIT license. It's in use by hundreds of projects. The main caveat is that it requires Python 3.8 or later and assumes you're comfortable organizing localized content as static markdown files.
Install
mkdocs-static-i18n on PyPI
Before you install
Low friction install as a pure Python wheel with a single runtime dependency on mkdocs. The project is actively maintained with a recent release and no known vulnerabilities.
Requires Python 3.8 or later and an existing MkDocs project.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.
Quickstart
pip install mkdocs-static-i18n
# In mkdocs.yml, add the plugin:
plugins:
- i18n
# Add localized markdown files:
# docs/index.md (default)
# docs/index.fr.md (French)
# docs/index.es.md (Spanish)Verify before relying
- Whether the plugin supports right-to-left language layouts or only left-to-right content
- Performance characteristics when managing documentation with many language variants
- Whether localized asset serving works for all file types or has restrictions
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagemkdocs |
| Maintenance | Actively maintained 175 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 660,685 / month, #5,458 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries :: Python Modules |
Evidence: mkdocs_static_i18n-1.3.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “mkdocs multilingual documentation”
- mkdocs-static-i18nA MkDocs plugin that adds static multi-language support to…
- zensicalZensical is a static site generator that converts Markdown…
- mkdocs-techdocs-coreBundles Spotify's TechDocs defaults—themes, plugins, and Markdown…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also mkdocs · mkdocstrings · mkdocs-git-revision-date-localized-plugin · mkdocs-meta-manager · mkdocs-video · mkdocs-material · mkdocs-redirects · mkdocs-macros-plugin · mkdocs-task-collector · mkdocs-multirepo-plugin