Saltar al contenido

← Volver a artículos

Markdown a PDF sin LaTeX: cómo funciona la canalización de impresión del navegador

Pregunta cómo convertir Markdown en un PDF y la respuesta canónica es Pandoc más un motor LaTeX: una cadena de herramientas que empieza con una descarga de TeX de varios gigabytes y a menudo termina con errores de fuentes y depuración de plantillas. Para un currículum, un informe o unas notas de reunión, es una cantidad notable de maquinaria.

Existe una segunda ruta que no necesita nada de eso: renderizar el Markdown a HTML, darle estilo con CSS paginado y dejar que el motor de impresión del propio navegador emita el PDF. Este artículo explica cómo funciona esa canalización, por qué su salida es un documento real y no una captura, dónde supera a LaTeX y dónde, honestamente, no.

El impuesto LaTeX sobre un trabajo sencillo

Pandoc es la respuesta correcta para la mayoría de las conversiones de documentos, pero su escritor de PDF es una excepción: Pandoc no renderiza PDF por sí mismo. Compone tu documento como fuente LaTeX y llama a un motor externo — pdflatex, xelatex o lualatex —, lo que significa una distribución TeX funcionando en tu máquina. Una instalación completa de TeX Live ocupa varios gigabytes; las variantes mínimas ahorran espacio hasta que el primer error de paquete faltante te devuelve al instalador.

Los conversores en la nube esquivan la instalación trasladando el problema: tu archivo va al servidor de alguien, espera en una cola y vuelve — si está por debajo del límite de tamaño y no has alcanzado el tope diario. Para borradores confidenciales, contratos y manuscritos inéditos, la propia subida es el factor decisivo. El trabajo — convertir texto estructurado en una página imprimible — no es intrínsecamente difícil. Las herramientas tradicionales solo hacen que lo parezca.

Qué hace realmente la canalización de impresión

La canalización tiene tres etapas, todas locales. Primero, el Markdown se convierte a HTML — en este sitio, con el mismo motor Pandoc WASM que impulsa el resto de las conversiones. Segundo, ese HTML se envuelve en un documento completo con una hoja de estilos de impresión: tamaño de página fijo, márgenes reales y una jerarquía tipográfica para encabezados, listas, código y tablas. Tercero, el motor de impresión del navegador pagina y escribe el PDF.

Esa tercera etapa hace más de lo que parece. Chrome, Edge, Firefox y Safari incorporan un motor de paginación maduro — el mismo que imprime recibos y tarjetas de embarque — y su salida «Guardar como PDF» es un PDF auténtico: glifos vectoriales con capa de texto. Puedes seleccionar oraciones en el resultado, buscar, copiar y pasárselo a un lector de pantalla. No es una imagen de tu documento; es tu documento, paginado.

CSS paginado: la parte que lo hace parecer un documento

La diferencia entre una página web impresa y un documento vive en un puñado de reglas CSS. La regla @page fija la hoja — aquí A4 con márgenes de 16 milímetros —, de modo que el diseño deja de depender del tamaño de la ventana. Los tamaños de fuente descienden del título por los niveles de encabezado, y el espaciado sigue convenciones de imprenta y no de pantalla.

Las reglas más sutiles gobiernan los saltos de página. Los encabezados llevan break-after: avoid, así que un título de sección nunca queda solo al pie de página mientras su párrafo empieza en la siguiente. Las tablas, los bloques de código, las citas y las imágenes llevan break-inside: avoid, así que el renderizador los mueve enteros a la página siguiente en lugar de partirlas por la mitad. Son exactamente las reglas que un procesador de textos aplica en silencio: aplicarlas explícitamente es lo que convierte una pestaña del navegador en una máquina de componer.

Dónde LaTeX sigue ganando

La honestidad sobre el límite importa. Si tu documento es una tesis con doscientas referencias cruzadas, un artículo para una revista que exige su plantilla exacta o matemáticas densas, instala TeX: nada compone ecuaciones como LaTeX, y ninguna revista acepta un «casi» en su estilo de casa. Las herramientas bibliográficas — BibTeX, CSL con variantes institucionales precisas — también son más profundas en el mundo TeX.

Ese límite deja la mayoría de los documentos reales al otro lado. Informes, currículums, documentación, facturas, notas de reunión, capítulos para revisión: necesitan tipografía limpia, saltos de página sensatos y una tabla que no se parta entre páginas. Para ese trabajo, la canalización de impresión no es un compromiso: es el camino más corto al mismo destino, y el bucle de iteración es más rápido porque no hay nada que instalar, compilar o depurar.

El dividendo de privacidad y velocidad

Como cada etapa se ejecuta en tu máquina, el documento nunca la abandona. No hay barra de progreso de subida porque no hay subida; no hay posición en la cola porque no hay cola; no hay cuenta porque no hay nada que medir. La canalización funciona en un avión, en una oficina de campo, en una máquina que no ha tocado internet desde que cargó la página.

La velocidad se sigue del mismo hecho. La conversión y la paginación tardan segundos, y el bucle de retroalimentación es corto: edita el Markdown, convierte de nuevo, mira la vista previa, imprime. Para quien itera sobre un documento — y un PDF suele ser el último paso de una iteración, no el primero —, quitar la instalación y la subida elimina la fricción que hace que la gente evite producir el PDF en absoluto.

Cómo obtener el mejor resultado

Algunos hábitos valen la pena. Empieza el documento con un único encabezado de primer nivel como título y mantén la jerarquía honesta: las reglas de salto mantienen los encabezados unidos a su texto, pero solo si la estructura es real. Mantén las tablas estrechas; una tabla que cabe en la columna impresa sobrevive entera, mientras que una demasiado ancha envuelve sus celdas. Da a las imágenes anchos sensatos y recuerda que los navegadores no imprimen colores de fondo por defecto: la hoja de estilos de aquí depende deliberadamente de bordes y espacios en blanco.

Por último, usa el diálogo de impresión como último control. La vista previa muestra la paginación real antes de guardar nada; es el momento de cambiar entre A4 y Carta según tu audiencia y de confirmar que ninguna tabla quedó mal colocada. Treinta segundos de revisión de la vista previa cuestan menos que un PDF que hay que rehacer después de enviarlo.

Sigue leyendo

Convertir Markdown a PDF