<edit>

Note from project maintainers:

There are multiple aspects to supporting multiple languages in MkDocs, each of which is addressed in its own separate issue as listed below. This is the primary issue which ties all of the various aspects together. It is best to discuss each aspect in its related issue. This issue will be closed when all of the related issues are resolved (accepted, rejected or otherwise).

1. Theme localization (l10n). This has been completed in Support theme localization (rework of #1778). #2299 and will be available in version 1.2.0.
2. Support multi-language search. This has been completed and is already available.
3. Add support for pages in multiple languages. There are currently two proposals for how to do this: Multi-language (the manual translate proposal) #774 which proposes a system in which pages are manually translated, and Multi-language (the auto-translate proposal) #617 which proposes a system in which pages are auto-translated using po files or the like. Some third party plugins exist to address these issues. It is likely that any native solution would come from a third party plugin if/when one establishes itself as well developed and is a clear favorite among users. Whether that means the plugin would be moved in-house or it would become the "recommended" solution and remain a third-party plugin will depend upon the circumstances at the time that such a decision is made.

At the time of this edit, no one on the MkDocs core team has a need for multi-language support. Therefore, this is not a high priority for us, The best way for you to move any of these issues forward is to volunteer your time and energy working on the issues. We will do our best to review PRs and shepherd discussions.

</edit>

It would be great if mkdocs supports i18n(Internationalization), just like gitbook. We can mkdir en and others. Then add a button in navbar to change the language which changes the docs_dir in fact.

I have found some solutions for jinjia2 i18n. Is it possible to implement with that?