PDF en el sitio: cuándo ofrecer el archivo y cómo avisarlo

Ofrece un PDF solo para lo que la persona va a imprimir o guardar, y siempre como copia de una página en HTML que ya cuenta lo esencial. El enlace al archivo debe decir que es un PDF y mostrar el número de páginas y el tamaño, para que la persona decida antes de hacer clic (NN/g, Avoid PDF for On-Screen Reading (en inglés)). Para leer en pantalla, una página normal funciona mejor.

Por qué el PDF estorba en pantalla

El PDF nació para el papel. La página tiene medida de hoja, no de ventana, así que en el móvil la persona tiene que ampliar, arrastrar y buscar dónde estaba (NN/g, PDF: Still Unfit for Human Consumption (en inglés)). Ese artículo, de 2020, reúne veinte años de pruebas y llega a la misma conclusión que el texto original de Jakob Nielsen, de 1996.

Los problemas que el NN/g más ve en las pruebas (NN/g (en inglés)):

No hay navegación. El archivo no tiene el menú del sitio, y el índice con enlaces no lo resuelve: la persona sigue recorriendo títulos hasta dar con la parte que busca.
Tarda en abrir. En uno de los estudios, el menú del comedor en PDF tardó casi 3 minutos en descargarse.
Desorienta. Si el archivo se abre en otra pestaña y nadie lo nota, el botón Atrás parece roto. Si se abre en la misma pestaña, la persona cierra la ventana creyendo que era otra y pierde el camino.
Envejece sin avisar. Las versiones viejas siguen publicadas con enlaces que apuntan a ellas, y quien encuentra una empieza a dudar del resto.

Cuándo tiene sentido un PDF

El NN/g da un criterio corto: el PDF sirve para documentos que se van a imprimir (NN/g (en inglés)). Un informe anual, un manual de montaje, un formulario que hay que firmar o un currículum que alguien adjunta a una oferta de empleo entran aquí.

Incluso en esos casos, el archivo no debería ser el único formato. La recomendación es observar antes si tu público de verdad imprime, porque mucha gente que recibe un PDF solo quería leer una parte en pantalla (NN/g (en inglés)).

La página va antes del archivo

La salida que propone el NN/g es la página de entrada: una página en HTML que resume lo que dice el documento y ofrece el archivo completo para descargar (NN/g (en inglés)). Quien solo quería la respuesta la encuentra ahí. Quien necesita el documento entero lo descarga sabiendo qué va a recibir.

Esa página también es la que debe aparecer en el buscador del sitio y en Google, no el PDF suelto. El NN/g cuenta que los archivos grandes suelen subir en los resultados de la búsqueda interna porque repiten mucho las palabras buscadas (NN/g (en inglés)). La persona hace clic y cae en la página 47 de un documento que solo menciona el tema de pasada.

Qué debe decir el enlace

Un enlace a un PDF debe mostrar tres cosas junto a él: que es un PDF, cuántas páginas tiene y cuánto pesa (NN/g (en inglés)). Así la persona decide si vale la pena gastar datos móviles y tiempo.

La misma guía enumera cuidados con el propio archivo (NN/g (en inglés)):

Ligero. Reduce las imágenes y quita lo que no hace falta.
Accesible. Texto que se pueda seleccionar, etiquetas de estructura para títulos y tablas, orden de lectura definido y texto alternativo en las imágenes.
Apto para los dos papeles. En Estados Unidos la hoja común es la carta, mientras que en Brasil se usa el A4, un poco más estrecho y más alto. El documento tiene que caber en los dos.
Sin versiones viejas publicadas. Retira la anterior y actualiza los enlaces. Si tiene que quedarse, indica en la primera página cuál es la versión vigente.

Descargar, abrir en la misma pestaña o en otra

No hay una regla única. El artículo del NN/g sobre pestañas nuevas dice que, en el ordenador, las personas de sus estudios solían consultar el PDF junto a la página de origen o imprimirlo. Por eso, ahí, abrirlo en otra pestaña funcionó mejor (NN/g, Opening Links in New Browser Windows and Tabs (en inglés)). En el móvil, la recomendación se invierte: si no puedes evitar el PDF, ábrelo en la misma pestaña, porque volver es más fácil.

Para archivos que la persona va a editar, como hojas de cálculo o presentaciones, el mismo texto prefiere la descarga directa, para que los abra en el programa que usa (NN/g (en inglés)). Elijas lo que elijas, avisa antes del clic cuando un enlace abre una pestaña nueva.

Qué controla el código

En HTML, el atributo download del elemento <a> le pide al navegador que guarde el archivo en lugar de abrirlo. Con un valor, sugiere el nombre del archivo guardado (MDN, el elemento a). Solo funciona con archivos del mismo origen que la página. Para un PDF alojado en otra dirección, el navegador lo ignora y simplemente sigue el enlace.

El servidor también opina, con la cabecera Content-Disposition. Cuando dice inline, es decir, mostrar en pantalla, el MDN explica que gana el atributo download y el archivo se descarga (MDN). En cambio, el nombre de archivo que envía el servidor gana sobre el nombre escrito en el atributo.

El atributo type, con el valor application/pdf, solo indica el formato y no cambia nada en el comportamiento del navegador (MDN).

El PDF también llega al buscador

Google lee e indexa los PDF como cualquier otra página (Google Search Central, tipos de archivo indexables). Eso es bueno cuando el archivo es la única fuente, y malo cuando existe la página de entrada y el buscador manda a la persona directo al PDF.

Como un PDF no tiene <head>, la etiqueta noindex no cabe en él. La forma de hacerlo es la cabecera de respuesta X-Robots-Tag: noindex, que Google acepta para recursos que no son HTML (Google Search Central, bloquear la indexación).

Cómo lo hice en kahue.net

El sitio estrenó un currículum en PDF el 30 de octubre de 2026, un archivo por idioma. El enlace “Descargar CV (PDF)” está arriba en la página de inicio y en la página sobre mí. La página sobre mí es la versión en HTML, con experiencia, formación y certificaciones, y el PDF es la copia para adjuntar a una candidatura.

Los tres archivos salen de un script, scripts/gera-cv.mjs, que arma el documento con los mismos datos que alimentan la página. Así el PDF no se queda atrás cuando cambia un cargo, que es el problema de la versión vieja que describe el NN/g. El nombre de cada archivo es fijo, como kahue-morais-es.pdf, así que el enlace no cambia con cada versión nueva.

En el código, el enlace tiene download con el nombre del archivo y type="application/pdf". El servidor responde con Content-Disposition: inline y el mismo nombre, así que los nombres no chocan. El archivo en portugués tiene 4 páginas A4 y 142 KB, el de inglés tiene 3 páginas, y todos salen con etiquetas de estructura.

Según la guía del NN/g, faltan tres cosas. El enlace dice que es un PDF, pero no muestra páginas ni tamaño. El archivo no tiene X-Robots-Tag: noindex, así que puede aparecer en el buscador en lugar de la página sobre mí. Y el diseño se pensó solo para A4.

Dónde las fuentes no coinciden

El propio NN/g no cierra la cuestión de la descarga directa. La guía sobre PDF dice que descargar puede ahorrarle a la persona leer el archivo en el navegador, pero que a algunas les molesta tener que abrirlo después en otro programa (NN/g (en inglés)). Los dos artículos terminan recomendando probar con tu propio público.

La documentación también cambia según el idioma. La versión en portugués del MDN todavía dice que, con inline, Firefox sigue al servidor y abre el archivo (MDN (en portugués)). La versión en inglés, más reciente, dice que gana el atributo (MDN (en inglés)). La versión en español explica la diferencia: solo Firefox anterior a la versión 82 seguía al servidor (MDN).

El error común: publicar el PDF en lugar de la página

El tropiezo más frecuente es recibir un documento terminado y subir el archivo como si fuera la página. El NN/g cuenta el caso de un equipo de intranet que oía siempre el mismo pedido: alguien entregaba un PDF y pedía publicarlo (NN/g (en inglés)). Parece más rápido, pero cada corrección posterior obliga a buscar el original, generar otro archivo y cambiar los enlaces.

Escribir la página primero exige la misma planificación del contenido. La diferencia es que una corrección se vuelve una sola edición, y el PDF vuelve a ser lo que debería: una copia para imprimir.