---
title: "Translate Markdown files"
description: "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."
canonical: "https://ai-glot.com/docs/formats/markdown"
updated: "2026-10-12"
---

# Translate Markdown files

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.

> **Tip: Try it free**
>
> Drop a file of up to 2 MB on the free [Markdown translator](https://ai-glot.com/file-formats/markdown-translation) to try it with no account, five files a day. The app, the API and the CLI take Markdown files up to 4 MB.

## 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

**Docs page**

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.

**README**

Keeps the badges and installation commands intact.

Translate this README into German. Leave badges, shell commands and file names exactly as they are.

**Blog post with front matter**

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.

**MDX component props**

Keeps components working while the surrounding text is translated.

Translate the prose into Italian. Leave imports, component tags and their props unchanged.

**Informal tone**

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](/docs/platform/glossaries) carries over.
- **A whole docs folder.** Put the files in a [ZIP](/docs/formats/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](/docs/formats/html) and [plain text](/docs/formats/plain-text).
- [YAML and TOML](/docs/formats/yaml-and-toml) for the config that sits next to your docs.
- [All file formats](/docs/formats)