Translate Markdown files
Translate .md, .markdown and .mdx files up to 4 MB. Code, link targets and structure stay intact, and front matter titles are translated. Example instructions included.
Markdown files (.md, .markdown and .mdx) are accepted up to 4 MB. AI Glot reads headings, paragraphs, list items and table cells as text and everything else as structure, so the file is ready to commit.
What is translated, and what is left alone
| Translated | Left as it was |
|---|---|
| Headings, paragraphs, list items, quotes and table cells | Fenced and indented code, inline code |
| Link text and emphasis, moved with the right words | Link targets and URLs |
Front matter title and description | Other front matter fields such as slugs, dates and tags |
| The words around inline code | HTML blocks, MDX imports, component tags and expressions |
Line endings and a byte-order mark are kept too.
What you can ask
The common case: translate prose, leave code and links alone.
Translate into French. Leave code blocks, inline code and URLs alone, and keep the product name Acme in English.
Keeps the badges and installation commands intact.
Translate this README into German. Leave badges, shell commands and file names exactly as they are.
Translates title and description and leaves the slug.
Translate into Spanish, including the front matter title and description. Do not change the slug, date or tags.
Keeps components working while the surrounding text is translated.
Translate the prose into Italian. Leave imports, component tags and their props unchanged.
Chooses the register for the target language.
Translate into Portuguese. Use an informal, friendly tone and address the reader as “você”.
Good to know
- One target language per upload. A file holds one language. If you ask for two, the plan translates one and says so. Run the file once per language: your glossary carries over.
- A whole docs folder. Put the files in a ZIP to translate them in one job and keep the folder layout.
- Ceiling. 4 MB. Output filter: not available, the whole file comes back.
- Component text in MDX. Text passed as component props is not prose. If a prop holds words people read, say so in your instruction.
Related
- HTML and plain text.
- YAML and TOML for the config that sits next to your docs.
- All file formats