Arquivos PGN: como ler, criar e compartilhar partidas

PGN, ou Portable Game Notation, é um formato de texto simples para armazenar partidas de xadrez. Um registro PGN combina pares de tags — como nomes dos jogadores e resultado — com lances em notação algébrica, comentários e variantes opcionais. Ele pode ser lido por pessoas e importado pela maioria dos softwares de xadrez.

Este guia faz parte da coleção de ferramentas de xadrez. Combine uma exportação PGN limpa com a checklist de análise de partidas para preservar tanto os lances quanto o raciocínio por trás das decisões críticas.

As duas partes de uma partida PGN

Um registro PGN contém:

1. pares de tags entre colchetes; e
2. texto dos lances com movimentos numerados e o resultado.

Exemplo:

[Event "Training Game"]
[Site "Online"]
[Date "2026.07.16"]
[Round "1"]
[White "Player A"]
[Black "Player B"]
[Result "1-0"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 1-0

A linha em branco entre as tags e os lances melhora a compatibilidade e a leitura.

As sete tags padrão

O conjunto padrão é:

• Event: torneio ou nome da partida;
• Site: local ou plataforma;
• Date: normalmente YYYY.MM.DD;
• Round: identificador da rodada;
• White: jogador das brancas;
• Black: jogador das pretas; e
• Result: 1-0, 0-1, 1/2-1/2 ou *.

Tags adicionais podem guardar ratings, códigos de abertura, controles de tempo, forma de encerramento, autor das anotações ou outros metadados. O suporte varia entre os programas.

Os lances usam notação algébrica

Movimentos como e4, Nf3, Bxc6, O-O e e8=Q seguem a notação algébrica. Os números organizam os turnos das brancas e das pretas.

O resultado final no texto dos lances deve corresponder à tag Result. Aprenda os símbolos no guia de notação algébrica do xadrez.

Comentários

Chaves armazenam comentários:

12. d5 {As brancas fecham o centro e ganham espaço na ala da dama.}

Em alguns contextos PGN, um ponto e vírgula pode iniciar um comentário até o fim da linha. As chaves são mais claras para anotações portáteis.

Comentários úteis explicam:

• a ameaça;
• os lances candidatos;
• a estrutura de peões;
• o tempo no relógio;
• a avaliação em palavras; e
• a lição de um erro.

Evite encher o arquivo com números da engine sem explicação.

Variantes

Parênteses armazenam linhas alternativas:

10. Re1 (10. d4 exd4 11. cxd4) 10...O-O

As variantes podem ser aninhadas, mas níveis demais dificultam a leitura. Mantenha a principal alternativa instrutiva e remova ramificações que não explicam uma decisão.

Símbolos de anotação e NAGs

Os símbolos legíveis incluem !, ?, !? e ?!. Os Numeric Annotation Glyphs (NAGs) usam códigos como $1 para indicar um bom lance em PGNs voltados para software.

Cada aplicativo pode exibir o mesmo símbolo de modo diferente. Use comentários quando a razão for importante.

Começar em uma posição personalizada

Uma partida que começa fora da posição inicial padrão usa tags de configuração:

[SetUp "1"]
[FEN "8/8/8/4k3/8/4K3/4P3/8 w - - 0 1"]

A FEN precisa conter os seis campos, e os lances devem ser legais a partir dessa posição. Leia o guia de posições FEN antes de criar um PGN com início personalizado.

PGN e FEN: qual é a diferença

• PGN armazena a partida, os lances, metadados, comentários e variantes.
• FEN armazena a fotografia de uma posição e um estado limitado.

Use PGN para revisar e reproduzir. Use FEN ao compartilhar um único problema ou uma posição de análise.

Como importar um PGN com segurança

Antes de importar:

1. confirme que o arquivo é texto simples;
2. examine as tags em busca de informações privadas;
3. confira se os resultados correspondem;
4. valide a legalidade dos lances;
5. verifique qualquer configuração FEN personalizada;
6. preserve o arquivo original; e
7. descubra se o aplicativo de destino aceita comentários e variantes.

Um parser pode rejeitar uma partida malformada enquanto as outras partidas no arquivo continuam válidas.

Problemas comuns de sintaxe

• Falta uma aspa ou o colchete de fechamento em uma tag.
• A tag de resultado e o resultado final dos lances não coincidem.
• Um lance algébrico é ilegal ou ambíguo.
• As chaves dos comentários ou os parênteses das variantes não estão equilibrados.
• Uma posição personalizada não tem SetUp "1".
• A FEN está incompleta.
• A codificação de caracteres não é padrão.
• Várias partidas não têm separação clara.

Valide depois de editar o arquivo manualmente.

Compartilhamento e privacidade

As tags PGN podem revelar nomes, usuários, locais de eventos, datas, ratings e anotações. Antes de publicar:

• remova dados pessoais desnecessários para a análise;
• peça autorização para comentários privados;
• evite expor a identidade ou a agenda de uma criança;
• confira os termos da plataforma para reutilização de partidas; e
• preserve a atribuição quando ela for obrigatória.

Texto simples é fácil de copiar, o que torna a revisão de privacidade especialmente importante.

Um fluxo útil de anotação

1. Exporte a partida original.
2. Adicione seus pensamentos sem engine.
3. Marque as posições críticas.
4. Acrescente uma ou duas variantes candidatas.
5. Verifique com uma engine.
6. Substitua avaliações numéricas por explicações.
7. Salve uma nova cópia anotada.

Mantenha o original intacto para poder recuperar o histórico de lances e os metadados.

Perguntas frequentes

Um arquivo PGN pode conter várias partidas?

Sim. Elas são armazenadas como registros PGN consecutivos, cada um com suas próprias tags e seu texto de lances.

PGN é um vídeo ou uma imagem do tabuleiro?

Não. É texto. O software de xadrez reconstrói o tabuleiro a partir dos lances.

PGN pode armazenar variantes de análise?

Sim. Os parênteses contêm variantes recursivas de anotação e as chaves contêm comentários.

Por que meu PGN não é importado?

Confira as aspas das tags, a coerência do resultado, o equilíbrio de chaves e parênteses, a legalidade da notação e qualquer FEN personalizada.

Referência: Portable Game Notation Specification.