Write multiple languages in a single note, then switch the visible language globally.

• 中文文档
• BiliBili Video

mi18n lets you keep every translation of a note in one file, then show only the language you need. Switch languages globally from the ribbon, status bar, or command palette — all open notes update instantly in reading mode, Live Preview, and source mode.

Wrap each language's content in a lang block:

:::lang en
Hello, world!
:::

:::lang zh-CN
你好，世界！
:::

Click the ribbon icon or the status bar badge to pick a language. Only that language's blocks are visible — everything else is hidden in both reading mode and the editor.

All four styles are interchangeable — use whichever fits your workflow:

Multi-language blocks — :::lang en zh-CN shows the block when either language is active.

Rules:

• Open and close markers must be on their own line with no leading spaces.
• Language code matching is case-insensitive (zh-CN and zh-cn are treated identically).
• Content outside any block is always visible regardless of the active language.
• Unclosed blocks extend to the end of the file.

mi18n automatically keeps these keys in sync — you rarely need to write them manually:

---
lang: [en, zh-CN, ja]   # languages present in this note (auto-synced on save)
lang_view: zh-CN         # lock this note to a specific language on every open
lang_ignore: true        # disable mi18n entirely for this note
title: "My Article"      # shown as the inline title for the default language
title_zh-CN: "我的文章"  # per-language title variant (title_<lang>)
---

When Override note title from frontmatter is enabled (Settings → Interface), mi18n replaces the inline title shown at the top of the note with the value from title (or the matching title_<lang> variant) instead of the filename. The base title is used for the default language and as a fallback for any language that has no dedicated variant.

Clicking the inline title temporarily reveals the real filename so you can rename the file normally — mi18n re-applies the translated title as soon as you finish.

Left-sidebar icon. Opens a language picker menu showing all configured languages plus Show all languages. Can be hidden in settings.

Bottom-right indicator shows the active language code. A warning dot appears when the current note is missing translations for some configured languages. Click for the full language menu.

Two icon buttons sit beside the badge:

• Compare — opens the language comparison dialog
• Language — same as clicking the badge

A floating language switcher appears at the top of every multilingual note in reading mode. Click any pill to switch. Includes ALL to show every block simultaneously.

When the Outline panel is open, a language switcher is injected at its top. Headings from inactive language blocks are hidden automatically so the outline stays clean.

Right-click anywhere in the editor → Multilingual submenu:

Hover over Copy / Paste as / Delete / Manual insert to reveal a language picker flyout. Languages that already exist in the note are shown as disabled in Paste as and Manual insert.

Right-click any Markdown file in the file explorer → Multilingual → Export → <language>

Exports that language's content (lang markers stripped) as a standalone .md file. If the selected language block is not found, shared content outside any block is exported with a notice.

Opens side-by-side panes showing different languages of the same note with synchronized scrolling.

To open: click the compare icon in the status bar → select two or more languages → Apply split view. Each pane locks to its language independently. Click Return to normal mode to close the comparison session.

The Smart AI translate modal provides:

Closing the modal or clicking Cancel immediately aborts the API request — no tokens are wasted mid-generation.

Supports any OpenAI-compatible API: OpenAI, Ollama, OpenRouter, SiliconFlow, and others. Configure under Settings → AI translation.

Open Settings → mi18n:

• Active language — the language shown across all notes right now
• Default language — assumed language for notes that have no lang markers (switching away makes those notes invisible)
• Configured languages — add / rename / remove entries; codes must exactly match your markers

• Override note title from frontmatter — display the title / title_<lang> frontmatter value as the inline title instead of the filename; clicking the title temporarily restores the filename for renaming
• Hide other languages in editor — collapse inactive blocks to a thin bar in Live Preview / source mode
• Show language switcher in reading mode — toggle the reading-mode pill bar
• Show ribbon button — toggle the left-sidebar icon
• Show status bar indicator — toggle the status bar badge

API Base URL · API Key · Model (e.g. gpt-4o-mini) · System prompt

Restrict mi18n to specific vault folders:

• Working directories — plugin only activates inside listed folders (empty = all files)
• Excluded directories — plugin is fully disabled inside these folders (takes priority over working directories)

A note with no lang markers is treated as written entirely in the Default Language. If you switch to a different language, the whole note becomes invisible — intentionally, because there is no translation for that language.

MIT