mkdocs-material/docs/guides/changing-the-language.md

template
overrides/main.html

Changing the language

Material for MkDocs supports internationalization (i18n) and provides translation keys for all template variables and labels in 40+ languages. Additionally, search can be configured to use a language-specific stemmer (if available).

Configuration

Site language

:octicons-file-code-24: Source · :octicons-tools-24: Default: en

You can set the language from mkdocs.yml with:

theme:
  language: en

The following languages are supported:

• af / Afrikaans
• ar / Arabic
• bn / Bengali (Bangla)
• ca / Catalan
• cs / Czech
• da / Danish
• de / German
• en / English
• es / Spanish
• et / Estonian
• fa / Persian (Farsi)
• fi / Finnish
• fr / French
• gl / Galician
• gr / Greek
• he / Hebrew
• hi / Hindi
• hr / Croatian
• hu / Hungarian
• id / Indonesian
• it / Italian
• ja / Japanese
• kr / Korean
• my / Burmese
• nl / Dutch
• nn / Norwegian (Nynorsk)
• no / Norwegian
• pl / Polish
• pt / Portuguese
• ro / Romanian
• ru / Russian
• sh / Serbo-Croatian
• si / Slovenian
• sk / Slovak
• sr / Serbian
• sv / Swedish
• th / Thai
• tr / Turkish
• uk / Ukrainian
• vi / Vietnamese
• zh / Chinese (Simplified)
• zh-Hant / Chinese (Traditional)
• zh-TW / Chinese (Taiwanese)
• Add language

Directionality

:octicons-file-code-24: Source · :octicons-tools-24: Default: best match for theme.language, automatically set

While many languages are read ltr (left-to-right), Material for MkDocs also supports rtl (right-to-left) directionality which is inferred from the selected language, but can also be set with:

theme:
  direction: ltr

:material-cursor-default-click-outline: click on a tile to change the directionality:

ltr rtl

Search

TBD