Hipervínculos y marcadores

Un PDF pensado para pantalla debe llevar anotaciones de enlace reales, no solo texto azul: URLs, correos mailto: y referencias internas tienen que ser clicables. En HTML, un <a href> se convierte en una anotación Link del PDF al exportar; el texto de color que solo parece enlace está muerto. Distingue enlaces externos (abren una URL) de los internos (saltan dentro del archivo).

El panel de marcadores (outline) del PDF es el mapa lateral del lector: constrúyelo desde la jerarquía h1–h3 del documento, no a mano. Anida los niveles para que los marcadores H2 vivan bajo su H1. En HTML–a–PDF, Prince y WeasyPrint leen bookmark-level / bookmark-label; Chrome headless no emite marcadores, así que agrégalos en post (pdfmarks de Ghostscript o Acrobat).

Cada entrada de un índice digital y cada "ver pág. 12" debe ser un enlace interno vivo que salte al ancla exacta, no solo un número impreso. En HTML usa <a href="#ancla"> y saca el número de página con target-counter(attr(href), page). Verifica tras repaginar: el ancla debe seguir existiendo y caer en el encabezado correcto.

Un enlace que el lector no ve es un enlace que no usará: mantén un color de acento consistente más subrayado, nunca solo color. La anotación clicable debe cubrir toda la frase con algo de relleno vertical; apunta a un objetivo de al menos ~24 px (unos 9 pt) de alto para acertarlo con el dedo. No envuelvas un enlace de modo que una sola letra o un espacio suelto sea la única zona sensible.

Chrome headless (--print-to-pdf) sí conserva los <a href> como anotaciones Link clicables, tanto externas como internas #ancla, así que no tienes que simularlas. Pero un #ancla solo funciona si el id destino existe en la página; y pasos posteriores pueden eliminarlas. Tras cualquier pasada de Ghostscript o "reducir tamaño", reabre el PDF y clica los enlaces para confirmar que siguen vivos.

Un PDF digital a menudo se imprime, y en papel un enlace clicable es solo tinta: el lector tiene que poder teclearlo. Prefiere una URL canónica escrita a "clic aquí" o a un acortador enmascarado que muera después. Para direcciones largas, imprime la forma corta visible y mantén el href completo vivo, o expón la URL en un estilo de impresión con a::after { content: ' (' attr(href) ')' }.

Un named destination es una etiqueta estable dentro del PDF (un nombre, no un número de página crudo) a la que herramientas externas pueden saltar: archivo.pdf#nameddest=metodo abre directo en esa sección. Sobreviven a la repaginación porque apuntan a contenido, no a la página N. En HTML–a–PDF, los id de elemento se vuelven los named destinations en Prince/Weasy; mantén los id significativos y únicos para que los enlaces tipo #page=5 sigan siendo fiables.

Los enlaces son navegación, no decoración: un párrafo salpicado de ellos se vuelve un arcoíris de subrayados que daña la lectura y esconde el único enlace que importa. La prosa debe sostenerse sola si se ignora o se imprime cada enlace. Agrupa las referencias al final de una sección, o súbelas a notas al pie/final, en vez de subrayar la mitad del cuerpo.

El Title, Author, Subject y Keywords del PDF son lo que muestran buscadores, sistemas DAM y la barra de título del lector, y PDF/A y PDF/UA exigen metadatos XMP correctos para conformar. Un Title en blanco hace que el archivo aparezca como su nombre de archivo crudo en pestañas y resultados. En HTML el <title> y <meta name="author"> alimentan el Document Info; defínelos, y prefiere XMP que coincida con la portada visible.

Los campos de formulario interactivos y botones de acción (enviar, limpiar, imprimir) van solo en PDFs de flujo digital real; un reporte o un maestro de impresión no debe cargarlos. Las acciones AcroForm suman peso, rompen algunos visores y están prohibidas por la conformidad de archivo PDF/A. Los motores HTML–a–PDF no emiten campos de formulario en absoluto, así que si de verdad necesitas un PDF rellenable, créalo en Acrobat, no desde un estilo de impresión.

Un enlace que resuelve en tu máquina pero no para el lector es una falla silenciosa: rutas file:///Users/…, localhost, dominios de staging y anclas muertas se publican rotos. Antes de exportar, reemplaza rutas locales y relativas por la URL final absoluta HTTPS, y corre un chequeo de enlaces para que cada href resuelva. Los enlaces internos #ancla deben coincidir con un id real; un destino faltante simplemente no hace nada al clicar.