Añadir números de página a un PDF: posición, número inicial y la trampa de las páginas rotadas

Añadir números de página escribe un número decimal simple en cada página de un PDF. Tú eliges la esquina, el tamaño de fuente y el primer número; todo lo demás es fijo. No sabe nada de páginas guardadas como rotadas, de portadas que deben quedar en blanco ni de números ya impresos en la página, y cada una de esas cosas requiere una decisión tuya antes de subir el archivo.

Qué escribe la herramienta

Cada número es texto Helvetica en negro añadido al contenido de la página, así que se imprime y viaja con el archivo en cualquier visor. No hay opción de fuente ni de color. No es el ajuste de etiquetas de página que algunos lectores muestran en el panel de miniaturas, así que un visor que muestre etiquetas como «iii» o «A-1» seguirá mostrando las suyas.

El formulario ofrece tres ajustes:

• Posición: arriba a la izquierda, arriba en el centro, arriba a la derecha, abajo a la izquierda, abajo en el centro o abajo a la derecha. El valor por defecto del formulario es abajo en el centro. En la API son los valores 1, 2, 3, 7, 8 y 9; 4, 5 y 6 colocan el número a la izquierda, en el centro y a la derecha de la mitad vertical.
• Número inicial: 1 por defecto. La primera página recibe este valor y cada página siguiente suma uno.
• Tamaño de fuente: 12 por defecto, de 6 a 200 en el formulario. La API no impone ese rango, así que mantente dentro de él.

El número inicial debe ser un entero: abc se rechaza con un 400 invalid_parameter, mientras que un valor negativo se acepta y se dibuja tal cual (-2, -1, 0, 1 y así sucesivamente).

El ancla del número está a 48 puntos (dos tercios de pulgada) de los bordes de la página, calculados a partir del tamaño del MediaBox de la página. Los dígitos se escriben desde el ancla hacia la derecha, así que «abajo en el centro» pone el borde izquierdo de los dígitos sobre la línea central y un número de tres cifras termina algo a la derecha del centro. «Abajo a la derecha» empieza a 48 puntos del borde derecho y avanza hacia él, así que un número de tres cifras a 12 pt termina a unos 28 puntos del borde. A 12 pt el desplazamiento cuesta notarlo.

Un ejemplo completo: el volumen II de un contrato

Toma un archivo de 6 páginas, contract.pdf, que continúa un primer volumen de 100 páginas. Súbelo a Añadir números de página, fija el número inicial en 101, la posición en abajo a la derecha y el tamaño en 12. En una ejecución del 2026-10-04 contra una compilación local, la salida fue un PDF de 6 páginas, y al extraer su texto aparecieron los números del 101 al 106, uno abajo a la derecha de cada página, debajo del texto principal. El renderizado de tu visor puede diferir en el detalle; el orden y los valores no.

Hay que saber dos cosas sobre ese resultado. La salida conserva el nombre de la entrada (contract.pdf), así que renómbrala antes de sobrescribir el original. Y una petición a la API sin position puso el número arriba a la derecha (valor 3), no abajo en el centro como el formulario. Envía position de forma explícita en los scripts.

Orden de las operaciones en un paquete de documentos

La herramienta numera todas las páginas del archivo que le das. No puede saltarse una portada ni reiniciar a mitad de archivo. Por eso el orden en que trabajas decide el resultado:

Si las páginas ya llevan un número impreso, el nuevo se dibuja además de él. Ejecutar la herramienta dos veces sobre el mismo archivo da dos números por página: en una prueba, una segunda pasada con la misma posición dibujó el nuevo «1» sobre el «101» existente, de modo que los dos se superponen. Conserva el original sin numerar y parte siempre de él.

Cómo recortar una portada o una sección de forma limpia, y qué pueden dejar las páginas eliminadas, se explica en Enviar solo algunas páginas de un PDF.

La trampa de las páginas rotadas

Las páginas de escáneres y móviles suelen guardarse con una marca de rotación en lugar de redibujarse. El número se coloca usando la página sin rotar, así que en una página guardada como rotada 90 grados cae en el borde equivocado y girado de lado. En la prueba, una página Carta marcada como rotada 90 grados y numerada «abajo en el centro» se mostró como una página horizontal con un «1» diminuto de lado en el borde izquierdo, más o menos a media altura, y no a lo largo de la parte inferior.

Cuando controlas el orden, numera primero y rota después con Rotar PDF. La rotación se aplica a toda la página, así que el número gira con el texto. Si un archivo llega ya marcado como rotado, esta herramienta no puede compensarlo y no hay ningún ajuste para corregirlo; revisa esas páginas en un visor después de numerar.

Comprueba antes de imprimir

Abre la primera página, una intermedia y la última. Busca dígitos sobre márgenes de perforación, fotos o un pie de página que ya contiene texto. Si el archivo tiene páginas en blanco al final, usa primero Eliminar páginas y numera después, para que el último número coincida con la última página real. Los números ya forman parte de la página, así que Extraer páginas o reordenar después los mantiene con sus páginas originales y la secuencia dejará de seguir el orden; vuelve a numerar desde el archivo sin numerar cuando cambie el orden.

Numera solo documentos que tengas permiso para modificar, y conserva el original sin numerar cuando un trámite de archivo espere una fuente sin marcas. Un archivo protegido con contraseña la necesita: la página del navegador la pide, y una llamada a la API sin ella recibe un 400 password_required («This PDF is password-protected. Enter its password.»), así que desbloquea antes el archivo. No hace falta clave de API para llamar a la herramienta.