---
title: "Como traduzir arquivos Markdown e MDX com IA"
description: "Traduza documentação, READMEs e changelogs em Markdown e MDX com IA. O código e os links permanecem como estão. Compare as opções e siga as etapas."
date: 2026-10-04
language: pt
canonical: https://ai-glot.com/pt/blog/how-to-translate-markdown-and-mdx-files-with-ai
source: AI Glot blog
---
**Traduzir Markdown é fácil até você ter duzentas páginas.** Aí, as palavras não são o problema. O desafio está em tudo ao redor: o código que não pode mudar, os links que precisam continuar funcionando e a próxima versão, que acrescenta mais dez páginas.

Este guia é para sites de documentação, READMEs, changelogs e pastas de blog escritos em Markdown ou MDX.

## Qual opção você deve usar?

| | Ideal para | Limitações |
|---|---|---|
| **AI Glot** | Uma pasta de documentação, vários idiomas, um glossário que precisa ser respeitado e cada nova versão | Não é necessário para um parágrafo curto de README |
| **Uma plataforma de gerenciamento de traduções** (Crowdin, Lokalise, Phrase) | Uma equipe com fluxo de trabalho contínuo, revisores e conexão com um repositório | É preciso configurar um projeto e conectar o repositório antes de traduzir a primeira página |
| **DeepL** | Os documentos listados: [Word, PowerPoint, Excel, PDF, HTML, texto e outros](https://developers.deepl.com/docs/best-practices/document-translations) | Markdown não está na lista, então você precisa colar o texto ou converter o arquivo antes |
| **ChatGPT, Claude ou outro assistente** | Uma página curta | Você cola cada página e leva seu glossário para cada conversa. É preciso verificar se o código ou os links mudaram em cada página, e uma pasta de documentação extensa consome seu limite de uso |
| **Um freelancer ou uma agência** | A landing page e a página de preços | O processo é lento, o preço é por palavra e você ainda precisa preparar os arquivos |

**Peça a uma pessoa para ler a página que vende o produto.** Traduza a documentação de referência com um mecanismo, porque é nela que está o volume.

## Por que o AI Glot é ideal para uma pasta de documentação

- **O conteúdo entra; a estrutura fica intacta.** Títulos, parágrafos, itens de lista e células de tabela são texto. O código, os destinos dos links, os blocos HTML e os separadores de tabela são mantidos como estão.
- **A formatação acompanha as palavras.** Negrito, itálico e texto dos links acompanham as palavras a que pertencem.
- **Um glossário para todo o site de documentação.** Os nomes dos produtos e os termos da API ficam consistentes em todas as páginas e na próxima versão.
- **Um plano antes de qualquer gasto.** Ele lista o que foi encontrado e o que será traduzido.
- **Uma pasta em uma única tarefa.** Coloque os arquivos em um ZIP e a estrutura será reconstruída.

## O fluxo de um arquivo

*Illustration: As cinco etapas de um trabalho com Markdown. Tudo antes da aprovação é grátis, então não custa nada corrigir um plano que interpretou a pasta errado.*

## O que muda em uma página

Só o texto é alterado. O código, o link e as chaves do front matter permanecem iguais.

*Illustration: Uma página de documentação antes e depois. O título é traduzido, mas o slug, o código e o destino do link permanecem como estão.*

## O que conferir no MDX

**Imports, tags de componentes e expressões permanecem intactos.** Assim, a página continua sendo compilada. O ponto de atenção é o texto passado a um componente como prop, por exemplo, um título enviado a um card. Ele pertence ao componente, não ao texto corrido. Por isso, confira essas poucas strings depois.

**Âncoras de títulos.** Se o seu site cria uma âncora com base no texto do título, um título traduzido gera uma nova âncora. Confira os links que apontam para um título, como a seção de instalação.

## Como fazer, passo a passo

**1. Experimente um arquivo grátis.** O [tradutor de Markdown](/pt/file-formats/markdown-translation) não exige conta e aceita arquivos de até 2 MB e 5,000 palavras.

**2. Envie o arquivo ou um ZIP da pasta** [no app](https://app.ai-glot.com/signup).

**3. Diga em uma frase o que você precisa.**

```
Translate this folder into French.
Translate the prose and the front matter title and description.
Leave every other front matter field as it is.
```

*Illustration: Você descreve o trabalho em inglês simples. O AI Glot o transforma em um plano que você pode ler e corrigir antes de qualquer execução.*

A frase define o que será traduzido em toda a pasta. Uma regra de redação, como "mantenha os nomes de produtos e termos de API em inglês", deve ser incluída no segundo campo durante a aprovação, porque ela se aplica a cada parágrafo conforme ele é escrito.

**4. Adicione um glossário** com nomes de produtos, termos de API e palavras que você sempre usa da mesma forma. [Veja como criar um](/pt/blog/build-translation-glossary-brand).

*Illustration: Um glossário define os termos que não podem variar e aplica a mesma decisão a todos os arquivos.*

**5. Confira o plano e escolha um nível de qualidade.**

*Illustration: Dois níveis de qualidade, escolhidos por arquivo. O Lite cobre cerca de três vezes mais palavras com os mesmos créditos.*

**Lite** oferece cerca de três vezes mais palavras por crédito e é mais rápido: ideal para atualizar em lote a documentação de referência. **Standard** é indicado para a landing page. Um crédito equivale a uma palavra no Standard.

**6. Aprove e baixe.**

*Illustration: Um único arquivo retorna, no mesmo formato em que foi enviado.*

## Uma pasta de documentação, vários idiomas

*Illustration: Uma pasta de documentação gera uma cópia traduzida por idioma, mantendo o mesmo layout e o mesmo glossário.*

Os números são um exemplo. Um arquivo Markdown contém um idioma, então cada idioma corresponde a uma cópia traduzida da pasta.

## Três maneiras de usar

*Illustration: Três maneiras de iniciar uma tarefa de Markdown. Todas geram os mesmos arquivos traduzidos.*

**Pela linha de comando** é a melhor opção para um repositório de documentação, porque as mesmas quatro etapas podem ser executadas em um script ou no CI sempre que o inglês mudar:

```bash
id=$(aiglot batches create docs.zip \
      --instruction "Translate into French. Translate the prose and the front matter title and description." \
      --json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
  --instructions "Keep product names and API terms in English."
aiglot batches download "$id" --output docs_fr.zip
```

**Com seu agente de IA:** conecte o AI Glot como um [servidor MCP](https://ai-glot.com/docs/mcp/overview). O agente pode ler seu repositório, sugerir os termos que encontrar para o glossário, executar o trabalho e devolver os arquivos ao lugar.

**No aplicativo:** envie, clique, baixe. Ideal para uma única página.

Para integrar via API, consulte a [documentação da API](https://ai-glot.com/docs/api/overview).

## Confira o resultado

Gere o site de documentação em um idioma traduzido e abra três páginas: uma com código, uma com uma tabela e outra com um link para outra página. Execute seu verificador de links habitual, porque é aí que uma alteração de âncora aparece. Mantenha os arquivos em inglês até que alguém que leia o idioma tenha conferido as páginas mais importantes.

[Preços](/pt/pricing) mostra quanto custa um volume maior, e uma [conta gratuita](https://app.ai-glot.com/signup) vem com créditos para você executar uma pasta de verdade.

---

*Os limites informados aqui são os que estavam em vigor quando este texto foi escrito: 4 MB por arquivo Markdown, 200 arquivos e 20 MB por ZIP, além de 2 MB e 5,000 palavras na ferramenta gratuita. A lista da DeepL vem da documentação da própria empresa. Os nomes dos arquivos e a quantidade de páginas nos diagramas são exemplos. Seu plano mostra os valores reais para seus arquivos, e a consulta é gratuita.*