Adicionar números de página a um PDF: posição, número inicial e a armadilha das páginas giradas

O Adicionar números de página escreve um número decimal simples em cada página de um PDF. Você escolhe o canto, o tamanho da fonte e o primeiro número; todo o resto é fixo. Ele não conhece páginas armazenadas como giradas, capas que devem ficar em branco nem números já impressos na página, e cada um desses casos exige uma decisão sua antes do envio.

O que a ferramenta escreve

Cada número é um texto Helvetica preto adicionado ao conteúdo da página, então ele é impresso e viaja com o arquivo em qualquer leitor. Não há opção de fonte nem de cor. Não é a configuração de rótulos de página que alguns leitores mostram no painel de miniaturas, então um leitor que exibe rótulos como "iii" ou "A-1" continuará mostrando os seus próprios rótulos.

O formulário expõe três configurações:

• Posição: canto superior esquerdo, centro superior, canto superior direito, canto inferior esquerdo, centro inferior ou canto inferior direito. O padrão do formulário é o centro inferior. Na API, esses são os valores 1, 2, 3, 7, 8 e 9; 4, 5 e 6 colocam o número à esquerda, no centro e à direita do meio vertical.
• Número inicial: padrão 1. A primeira página recebe esse valor e cada página seguinte soma um.
• Tamanho da fonte: padrão 12, de 6 a 200 no formulário. A API não impõe esse intervalo, então fique dentro dele.

O número inicial deve ser um número inteiro: abc é rejeitado com um 400 invalid_parameter, enquanto um valor negativo é aceito e desenhado como está (-2, -1, 0, 1 e assim por diante).

A âncora do número fica a 48 pontos (dois terços de polegada) das bordas da página, calculados a partir do tamanho da MediaBox da página. Os dígitos são escritos da âncora para a direita, então "centro inferior" põe a borda esquerda dos dígitos na linha central e um número de três dígitos termina um pouco à direita do centro. "Canto inferior direito" começa a 48 pontos da borda direita e avança em direção a ela, então um número de três dígitos a 12 pt termina a cerca de 28 pontos da borda. A 12 pt, essa diferença é difícil de notar.

Um exemplo completo: o volume II de um contrato

Imagine um arquivo de 6 páginas, contract.pdf, que continua um primeiro volume de 100 páginas. Envie-o ao Adicionar números de página, defina o número inicial como 101, a posição como canto inferior direito e o tamanho como 12. Em uma execução em 2026-10-04 contra uma versão local, a saída foi um PDF de 6 páginas, e a extração do texto mostrou os números de 101 a 106, um no canto inferior direito de cada página, abaixo do texto do corpo. A renderização no seu leitor pode diferir em detalhes; a ordem e os valores, não.

Duas coisas a saber sobre esse resultado. A saída mantém o nome da entrada (contract.pdf), então renomeie-a antes de sobrescrever o original. E uma requisição à API sem position pôs o número no canto superior direito (valor 3), não no centro inferior do formulário. Envie position explicitamente nos scripts.

Ordem das operações para um pacote

A ferramenta numera todas as páginas do arquivo que você entrega. Ela não consegue pular uma capa nem reiniciar no meio. Por isso a ordem em que você trabalha decide o resultado:

Se as páginas já trazem um número impresso, o novo é desenhado além dele. Executar a ferramenta duas vezes no mesmo arquivo dá dois números por página: em um teste, uma segunda passada com a mesma posição desenhou o novo "1" sobre o "101" existente, então os dois se sobrepõem. Guarde o original sem números e comece sempre a partir dele.

Como cortar uma capa ou uma seção de modo limpo, e o que as páginas removidas podem deixar para trás, está em Enviar só algumas páginas de um PDF: Extrair páginas, Remover páginas e o que fica para trás.

A armadilha das páginas giradas

Páginas de scanners e de celulares costumam ser armazenadas com um sinalizador de rotação em vez de redesenhadas. O número é posicionado usando a página sem rotação, então, em uma página armazenada como girada 90 graus, ele cai na borda errada e virado de lado. No teste, uma página Carta marcada como girada 90 graus e numerada em "centro inferior" apareceu como uma página em paisagem com um minúsculo "1" de lado na borda esquerda, mais ou menos na metade da altura, e não ao longo da base.

Quando você controla a ordem, numere primeiro e gire depois com o Girar PDF. A rotação vale para a página inteira, então o número gira junto com o texto. Se um arquivo já chega marcado como girado, esta ferramenta não consegue compensar e não há configuração para corrigir; confira essas páginas em um leitor depois de numerar.

Confira antes de imprimir

Abra a primeira página, uma do meio e a última. Procure dígitos sobre as margens dos furos, sobre fotos ou sobre um rodapé que já tenha texto. Se o arquivo tiver páginas em branco no final, use antes o Remover páginas e numere depois, para que o último número corresponda à última página de verdade. Os números agora fazem parte da página, então usar o Extrair páginas ou reordenar depois os mantém com as páginas originais e a sequência deixará de seguir a ordem; renumere a partir do arquivo sem números quando a ordem mudar.

Numere apenas documentos que você tem permissão para alterar e guarde o original sem números quando um processo de arquivamento esperar uma fonte sem marcas. Um arquivo protegido por senha precisa da senha: a página do navegador a pede, e uma chamada à API sem ela recebe um 400 password_required ("This PDF is password-protected. Enter its password."), então desbloqueie o arquivo antes. Não é preciso chave de API para chamar a ferramenta.