PDF no site: quando oferecer o arquivo e como avisar no link

Ofereça PDF só para o que a pessoa vai imprimir ou guardar, e sempre como cópia de uma página em HTML que já traz o essencial. O link para o arquivo precisa dizer que é PDF e mostrar o número de páginas e o tamanho, para que ela decida antes de clicar (NN/g, Avoid PDF for On-Screen Reading (em inglês)). Para leitura na tela, a página comum funciona melhor.

Por que o PDF atrapalha na tela

O PDF nasceu para o papel. A página tem medida de folha, não de janela, então no celular a pessoa precisa ampliar, arrastar e procurar onde estava (NN/g, PDF: Still Unfit for Human Consumption (em inglês)). Esse artigo, de 2020, junta vinte anos de testes e chega à mesma conclusão do texto original de Jakob Nielsen, de 1996.

Os problemas que o NN/g mais vê nos testes (NN/g (em inglês)):

Falta navegação. O arquivo não tem o menu do site, e o índice clicável não resolve: a pessoa ainda varre títulos até achar o trecho.
Demora para abrir. Num dos estudos, o cardápio do refeitório em PDF levou quase 3 minutos para baixar.
Desorienta. Se o arquivo abre em outra aba e ninguém percebe, o botão Voltar parece quebrado. Se abre na mesma aba, a pessoa fecha a janela achando que era outra e perde o caminho.
Envelhece calado. Versões antigas ficam no ar com links apontando para elas, e quem encontra uma passa a duvidar do resto.

Quando o PDF faz sentido

O NN/g dá um critério curto: PDF serve para documento que vai ser impresso (NN/g (em inglês)). Um relatório anual, um manual de montagem, um formulário que precisa de assinatura ou um currículo que a pessoa anexa a uma vaga entram aqui.

Mesmo nesses casos, o arquivo não deve ser o único formato. A recomendação é observar antes se o público realmente imprime, porque muita gente que recebe um PDF só queria ler um trecho na tela (NN/g (em inglês)).

A página vem antes do arquivo

A saída que o NN/g defende é a página de entrada: uma página em HTML que resume o que o documento diz e oferece o arquivo completo para baixar (NN/g (em inglês)). Quem só queria a resposta resolve ali. Quem precisa do documento inteiro baixa sabendo o que vai receber.

Essa página também é a que deve aparecer na busca do site e no Google, e não o PDF solto. O NN/g conta que arquivos grandes costumam subir nos resultados da busca interna por repetirem muito as palavras procuradas (NN/g (em inglês)). A pessoa clica e cai na página 47 de um documento que só cita o assunto de passagem.

O que o link precisa dizer

Um link para PDF deve anunciar três coisas perto dele: que é um PDF, quantas páginas tem e quanto pesa (NN/g (em inglês)). Com isso a pessoa decide se vale gastar dados móveis e tempo.

O mesmo guia lista cuidados com o próprio arquivo (NN/g (em inglês)):

Leve. Reduza imagens e corte o que não precisa estar ali.
Acessível. Texto que dá para selecionar, marcação de estrutura para títulos e tabelas, ordem de leitura definida e texto alternativo nas imagens.
Bom nos dois papéis. Nos Estados Unidos a folha comum é a carta, um pouco mais larga e mais curta que o A4 usado no Brasil. O documento precisa caber nas duas.
Sem versão velha no ar. Retire a anterior e atualize os links. Se ela precisar ficar, diga na primeira página qual é a versão atual.

Baixar, abrir na mesma aba ou em outra

Não há uma regra única. O artigo do NN/g sobre abas novas diz que, no computador, as pessoas dos estudos costumavam consultar o PDF junto com a página de origem ou imprimi-lo. Por isso, ali, abrir em outra aba funcionou melhor (NN/g, Opening Links in New Browser Windows and Tabs (em inglês)). No celular, a recomendação inverte: se não der para evitar o PDF, abra na mesma aba, porque voltar fica mais fácil.

Para arquivos que a pessoa vai editar, como planilha ou apresentação, o mesmo texto prefere baixar direto, para ela abrir no programa que usa (NN/g (em inglês)). Qualquer que seja a escolha, avise antes do clique quando o link abre uma aba nova.

O que o código controla

No HTML, o atributo download do elemento <a> pede ao navegador que salve o arquivo em vez de abri-lo. Com um valor, ele sugere o nome do arquivo salvo (MDN, o elemento a). Ele só vale para arquivos do mesmo domínio da página. Para um PDF hospedado em outro endereço, o navegador ignora o pedido e só abre o link.

O servidor também opina, pelo cabeçalho Content-Disposition. Quando ele diz inline, que é abrir na tela, a versão em inglês do MDN explica que o atributo download vence e o arquivo é baixado (MDN, a (em inglês)). Já o nome de arquivo enviado pelo servidor vence o nome escrito no atributo.

O atributo type, com o valor application/pdf, só informa o formato e não muda nada no comportamento do navegador (MDN, a (em inglês)).

O PDF também entra na busca

O Google lê e indexa PDF como qualquer página (Google Search Central, tipos de arquivo indexáveis). Isso é bom quando o arquivo é a única fonte, e ruim quando existe a página de entrada e a busca manda a pessoa direto para o PDF.

Como um PDF não tem <head>, a tag noindex não cabe nele. O caminho é o cabeçalho de resposta X-Robots-Tag: noindex, que o Google aceita para recursos que não são HTML (Google Search Central, bloquear a indexação).

Como fiz no kahue.net

O site ganhou um currículo em PDF em 30 de outubro de 2026, um arquivo por idioma. O link “Baixar currículo (PDF)” fica no topo da página inicial e da página sobre mim. A página sobre é a versão em HTML, com experiência, formação e certificações, e o PDF é a cópia para anexar a uma candidatura.

Os três arquivos saem de um script, scripts/gera-cv.mjs, que monta o documento com os mesmos dados que alimentam a página. Assim o PDF não fica para trás quando um cargo muda, que é o problema de versão velha descrito pelo NN/g. O nome de cada arquivo é fixo, como kahue-morais-pt-br.pdf, então o link não muda a cada nova versão.

No código, o link tem download com o nome do arquivo e type="application/pdf". O servidor responde com Content-Disposition: inline e o mesmo nome, então não há conflito de nome. O arquivo em português tem 4 páginas A4 e 142 KB, o em inglês tem 3 páginas, e todos saem com marcação de estrutura.

Pelo guia do NN/g, faltam três coisas. O link diz que é PDF, mas não mostra páginas nem tamanho. O arquivo não tem X-Robots-Tag: noindex, então pode aparecer na busca no lugar da página sobre. E o layout foi pensado só para A4.

Onde as fontes divergem

O próprio NN/g não fecha questão sobre baixar direto. O guia sobre PDF diz que baixar pode poupar a pessoa de ler o arquivo no navegador, mas que algumas se incomodam de ter que abri-lo depois em outro programa (NN/g (em inglês)). A recomendação final dos dois artigos é testar com o próprio público.

A documentação também diverge entre idiomas. A versão em português do MDN ainda diz que, com inline, o Firefox segue o servidor e abre o arquivo (MDN). A versão em inglês, mais nova, diz que o atributo vence (MDN (em inglês)). A versão em espanhol explica a diferença: só o Firefox anterior à versão 82 seguia o servidor (MDN (em espanhol)).

O erro comum: publicar o PDF no lugar da página

O tropeço mais frequente é receber um documento pronto e subir o arquivo como se fosse a página. O NN/g conta de uma equipe de intranet que ouvia sempre o mesmo pedido: alguém entregava um PDF e pedia para pôr no ar (NN/g (em inglês)). Parece mais rápido, mas cada correção depois exige achar o original, gerar outro arquivo e trocar os links.

Escrever a página primeiro dá o mesmo trabalho de planejar o conteúdo. A diferença é que a correção vira uma edição só, e o PDF passa a ser o que deveria ser: uma cópia para imprimir.