O que é XFDF? O formato XML para anotações PDF explicado

Um arquivo XFDF é a representação XML das anotações PDF. XFDF significa XML Forms Data Format, e foi introduzido pela Adobe como uma forma portátil e fácil de ler diretamente de transportar destaques, comentários e dados de formulário PDF separadamente do próprio documento PDF. Em vez de incorporar anotações dentro do PDF binário, o XFDF as armazena em uma estrutura XML de texto simples que qualquer ferramenta moderna pode analisar, comparar e converter — que é exatamente por que o pdfannotations.com o usa como formato de entrada ao lado de PDF e XML FDF.

Se você já exportou anotações do Adobe Acrobat e acabou com um pequeno arquivo .xfdf ao lado do seu PDF, este guia explica o que aquele arquivo realmente contém, como ele se compara ao antigo formato FDF e como abrir, visualizar e converter arquivos XFDF em Markdown, notas do Obsidian, JSON ou CSV.

O que significa XFDF?

XFDF se expande para XML Forms Data Format. Decompondo isso:

• XML — o arquivo é Extensible Markup Language puro, o que significa que você pode abri-lo em qualquer editor de texto, compará-lo no git e analisá-lo com qualquer biblioteca XML padrão.
• Forms Data — o formato foi originalmente projetado para transportar valores de campos de formulário, mas a Adobe o estendeu para transportar também dados de anotação (destaques, notas adesivas, sublinhados, riscados, texto livre).
• Format — é uma especificação publicada, não um blob binário proprietário. A Adobe documenta o esquema XFDF no SDK do Acrobat.

O resultado é um arquivo XML minúsculo — muitas vezes apenas alguns kilobytes — que captura cada anotação que você criou em um PDF, pronto para ser reimportado para o Acrobat ou alimentado em um conversor como o pdfannotations.com.

O que há dentro de um arquivo XFDF?

Um arquivo XFDF é XML estruturado. O elemento raiz é <xfdf>, e dentro dele você normalmente encontra:

<?xml version="1.0" encoding="UTF-8"?>
<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve">
  <f href="research-paper.pdf"/>
  <ids original="abc123def456" modified="789012abc"/>
  <annots>
    <highlight page="0" color="#FFEB3B" opacity="1.0"
               subject="Highlight" name="ann_001"
               date="D:20260720120000Z" creationdate="D:20260720115900Z">
      <contents>This is the key argument of the paper.</contents>
      <Popup page="0" rect="100,200,300,250" open="no"/>
    </highlight>
    <text page="2" color="#4F46E5" opacity="1.0"
          subject="Note" name="ann_002"
          date="D:20260720121000Z">
      <contents>Review this section carefully before citing.</contents>
      <Popup page="2" rect="120,220,260,260" open="no"/>
    </text>
    <underline page="5" color="#FF9800"
               subject="Underline" name="ann_003"
               date="D:20260720121500Z">
      <contents>Definition of construct validity.</contents>
      <Popup page="5" rect="80,180,300,220" open="no"/>
    </underline>
  </annots>
</xfdf>

Os elementos mais importantes são:

Elemento	Propósito
<f href="..."/>	Aponta de volta para o nome do arquivo PDF de origem.
<ids>	Identificadores internos do Acrobat usados para a ida e volta.
<annots>	Contêiner para todos os elementos de anotação.
<highlight>, <text>, <underline>, <strikeout>	Tipos de anotação individuais.
atributo page	Número da página indexado a partir de zero onde a anotação reside.
atributo color	Cor RGB hexadecimal da marcação.
date / creationdate	Formato de data PDF da Adobe (D:YYYYMMDDHHmmSSZ).
<contents>	O texto de comentário ou nota que você digitou.
<Popup>	Posição do popup flutuante de comentário no PDF de origem.

Como o XFDF é XML puro, você pode inspecionar qualquer anotação manualmente, escrever scripts contra ele ou convertê-lo em qualquer outro formato com algumas linhas de código.

XFDF vs FDF vs anotações PDF

Anotações PDF podem viver em três lugares diferentes, e cada um tem compensações. Entender a diferença ajuda você a escolher o formato certo para seu fluxo de trabalho.

Anotações PDF incorporadas

Anotações vivem dentro do próprio arquivo PDF como parte do array de anotações da página. É isso que acontece quando você destaca texto e simplesmente salva o PDF.

• Prós: Autossuficiente — um arquivo tem tudo.
• Contras: Cada edição reescreve o PDF (potencialmente enorme). Compartilhar anotações significa compartilhar o documento inteiro. Difícil de comparar ou versionar.

FDF (Forms Data Format)

FDF é o formato mais antigo da Adobe para transportar dados de formulário e anotações separadamente do PDF. Ele pode usar a forma binária tradicional, com sintaxe de objetos no estilo do PDF, ou uma codificação XML.

• Prós: Menor que o PDF completo; conversão de reimportação sem perdas com o Acrobat.
• Contras: O binário tradicional não é legível, gera diffs confusos e exige analisadores especializados; o XML FDF é legível, mas tem menos suporte que o XFDF.

XFDF (XML Forms Data Format)

XFDF é o sucessor XML do FDF. Mesmo modelo de dados, mas codificado como XML.

• Prós: Fácil de ler diretamente, compara de forma limpa no git, trivialmente analisável por qualquer biblioteca XML, menor que FDF na maioria dos casos, suportado por virtualmente toda ferramenta PDF moderna.
• Contras: Tamanho de arquivo ligeiramente maior que FDF devido à verbosidade do XML (mas ainda minúsculo — alguns KB).

Comparação rápida

Propriedade	PDF incorporado	FDF	XFDF
Codificação	Binário	Binário ou XML	XML (texto simples)
Fácil de ler diretamente	Não	Somente XML FDF	Sim
Diff limpo no git	Não	Somente XML FDF	Sim
Contém dados de anotação	Sim	Sim	Sim
Contém conteúdo de página	Sim	Não	Não
Tamanho de arquivo	Grande	Pequeno	Pequeno
Ida e volta com o Acrobat	Sim	Sim	Sim
Suportado pelo pdfannotations.com	Sim	Somente XML FDF	Sim

Para quase todos os fluxos de trabalho modernos, XFDF é a escolha certa. É o formato que a Adobe recomenda para novos projetos, e o formato de texto com suporte mais amplo que você pode inspecionar manualmente de forma significativa.

Por que usar XFDF em vez de anotações incorporadas?

Há vários cenários onde exportar XFDF é preferível a deixar anotações incorporadas no PDF:

1. Compartilhar anotações sem compartilhar o documento. Você pode enviar a um colega um arquivo XFDF de 5 KB em vez de um PDF de 50 MB. Ele o aplica à sua própria cópia do PDF no Acrobat.
2. Controle de versão de anotações. Como XFDF é texto simples, você pode fazer commit dele no git junto com o PDF e rastrear exatamente quais destaques foram adicionados quando.
3. Converter anotações em outros formatos. XFDF é a entrada mais fácil para ferramentas como pdfannotations.com — a estrutura XML mapeia diretamente para cabeçalhos Markdown, campos JSON e colunas CSV.
4. Múltiplos revisores. Cada revisor pode exportar seu próprio XFDF do mesmo PDF de origem, e você pode mesclá-los depois sem sobrescrever as anotações uns dos outros.
5. Arquivamento de longo prazo. XFDF sobreviverá a qualquer leitor PDF específico. Enquanto existirem analisadores XML (o que acontecerá no futuro previsível), suas anotações permanecem legíveis.

Como abrir um arquivo XFDF

Como XFDF é XML puro, você tem muitas opções para abri-lo:

Abrir em um editor de texto

Qualquer editor de texto — VS Code, Sublime Text, Notepad, BBEdit, Vim — pode abrir um arquivo XFDF. Esta é a forma mais rápida de inspecionar o que há dentro sem instalar nada. A estrutura XML é autodocumentada uma vez que você conhece os nomes dos elementos (mostrados acima).

Abrir em um navegador

Arraste o arquivo .xfdf para qualquer navegador moderno. Navegadores renderizam XML com nós recolhíveis, o que é uma forma útil de navegar rapidamente por um grande conjunto de anotações.

Reimportar para o Adobe Acrobat

No Acrobat, escolha File → Import → Data (ou Comments → Import Comments), selecione seu arquivo XFDF, e o Acrobat irá reanexar as anotações ao PDF correspondente. O PDF deve ser o mesmo documento (ou uma cópia dele) para que as anotações caiam nas posições corretas.

Importar no pdfannotations.com

Arraste o arquivo XFDF para o nosso conversor de anotações XFDF. O analisador é executado inteiramente no seu navegador — o arquivo nunca é enviado a um servidor — e renderiza cada anotação em um espaço de trabalho ordenável e filtrável onde você pode convertê-lo em Markdown, Obsidian, Notion, CSV, JSON ou texto simples.

Analisar com código

Como XFDF é XML, analisá-lo em qualquer linguagem de programação leva apenas algumas linhas. Por exemplo, em Python:

import xml.etree.ElementTree as ET

tree = ET.parse('annotations.xfdf')
root = tree.getroot()
ns = {'xfdf': 'http://ns.adobe.com/xfdf/'}

for annot in root.findall('.//xfdf:annots/*', ns):
    page = annot.get('page')
    color = annot.get('color')
    contents = annot.findtext('xfdf:contents', default='', namespaces=ns)
    print(f"Page {page} [{color}]: {contents}")

Esse trecho imprime cada anotação no arquivo em menos de 20 linhas. A mesma lógica se aplica em JavaScript, Go, Rust, Java ou qualquer linguagem com uma biblioteca XML.

Como converter um arquivo XFDF

Depois de ter um arquivo XFDF, você tipicamente deseja convertê-lo em um formato mais útil. As opções de conversão disponíveis no pdfannotations.com são:

• Markdown — genérico, portátil, funciona em qualquer editor Markdown
• Obsidian — Markdown com Callouts, YAML Frontmatter e [[Page References]]
• Notion — linhas estruturadas para um banco de dados Notion
• CSV — para Excel, Google Sheets ou análise de tabelas dinâmicas
• JSON — para pipelines programáticos
• Text — texto simples, útil para colar em email ou chat
• Excel — arquivo .xlsx com colunas estruturadas
• ZIP — empacota múltiplos formatos de uma vez
• AI Context Markdown — estruturado para colar no ChatGPT, Claude ou Gemini
• RAG JSON — esquema projetado para embedding e ingestão em banco de dados vetorial

Para instruções passo a passo sobre como obter XFDF do Adobe Acrobat em primeiro lugar, veja nosso guia de exportação de anotações XFDF.

Tamanho e limites de arquivos XFDF

Arquivos XFDF são minúsculos. Um artigo acadêmico de 300 páginas com 200 destaques e 50 notas adesivas produz um arquivo XFDF de aproximadamente 20–40 KB. Não há limite superior prático imposto pelo próprio formato — o Acrobat pode exportar XFDF de documentos com milhares de anotações — mas se você está lidando com conjuntos de anotações extremamente grandes, pode querer dividir a exportação por seção do documento para manter arquivos individuais gerenciáveis.

O pdfannotations.com lida com arquivos XFDF de qualquer tamanho que o navegador possa manter na memória, o que na prática significa dezenas de milhares de anotações por sessão sem desaceleração notável.

Mitos comuns sobre XFDF

"XFDF só funciona com Adobe Acrobat"

Falso. XFDF é um esquema XML aberto publicado pela Adobe, mas qualquer leitor PDF que suporte o padrão pode lê-lo e escrevê-lo. Foxit, PDF-XChange, Nitro e muitos outros leitores lidam com XFDF corretamente. O pdfannotations.com também analisa XFDF produzido por qualquer ferramenta compatível, não apenas o Acrobat.

"XFDF está obsoleto"

Falso. XFDF permanece o formato de intercâmbio recomendado para anotações PDF. O que foi efetivamente substituído foi o FDF binário tradicional. Para ler XML FDF, use o conversor de anotações FDF; para XFDF, use o conversor de anotações XFDF.

"XFDF não pode transportar dados de formulário"

Falso. XFDF transporta tanto dados de formulário quanto dados de anotação. O elemento <fields> retém valores de campos de formulário; o elemento <annots> retém anotações. A maioria das exportações XFDF do Acrobat foca no lado de anotação, mas o formato suporta ambos.

"XFDF perde informações de cor"

Falso. O atributo color em cada elemento de anotação armazena o valor RGB como uma string hexadecimal. Contanto que você tenha usado as ferramentas padrão Destaque ou Comentário do Acrobat, as cores se mantêm na reimportação através do XFDF.

Quando você deve usar XFDF?

XFDF é a escolha certa quando você precisa de qualquer um dos seguintes:

• Um arquivo de anotações portátil que é transferido separadamente do PDF de origem
• Um formato fácil de ler diretamente que você pode inspecionar, comparar ou editar manualmente
• Uma entrada convertível para uma ferramenta como o pdfannotations.com que transforma anotações em Markdown, Obsidian, JSON ou CSV
• Uma representação versionável de anotações no git
• Um fluxo de trabalho multi-revisor onde cada pessoa exporta seu próprio XFDF e você os mescla depois

Se você apenas lê PDFs em um único leitor e nunca precisa reutilizar os destaques em outro lugar, as anotações PDF incorporadas estão bem. No momento em que você quer fazer qualquer coisa além de ler, XFDF se torna a melhor escolha.

Perguntas Frequentes

O que significa .xfdf?

XFDF significa XML Forms Data Format. É a representação codificada em XML dos dados de formulário e anotações PDF.

XFDF é o mesmo que FDF?

Não. O FDF tradicional usa a sintaxe de objetos no estilo do PDF; XFDF é o sucessor XML. O Acrobat também pode exportar XML FDF, mas XFDF é mais legível, mais compatível e mais fácil de analisar.

Posso abrir um arquivo XFDF sem o Adobe Acrobat?

Sim. XFDF é XML puro, então qualquer editor de texto, navegador ou analisador XML pode abri-lo. Para convertê-lo em Markdown, Obsidian, CSV ou JSON, use o conversor XFDF do pdfannotations.com.

XFDF preserva cores de destaque?

Sim. Cada elemento de anotação carrega um atributo color com o valor RGB hexadecimal, que o pdfannotations.com preserva em todos os formatos de exportação.

Posso editar um arquivo XFDF manualmente?

Sim. Como XFDF é XML puro, você pode abri-lo em qualquer editor de texto e modificar texto, cores ou números de página das anotações diretamente. Basta salvar o arquivo como texto simples com a extensão .xfdf.

Guias relacionados

Quer aprender mais? Confira estes guias relacionados:

• Como exportar anotações XFDF do Adobe Acrobat - Instruções passo a passo para obter um arquivo XFDF do Acrobat para um conversor
• XFDF para Obsidian: converta anotações PDF da Adobe em Markdown - Transforme exportações XFDF em notas do Obsidian linkadas e etiquetadas com Callouts e Frontmatter
• Anotações PDF para IA e RAG - Alimente anotações exportadas em XFDF no ChatGPT, Claude, Gemini ou um banco de dados vetorial
• Exportar destaques PDF para Obsidian: guia completo de fluxo de trabalho - O fluxo de trabalho Obsidian completo para qualquer fonte PDF
• PDF para Markdown melhores práticas - Padrões de conversão limpos que funcionam no Obsidian, Notion e além