Convierte Markdown a PDF sin perder el documento
Markdown está pensado para una pantalla que se desplaza. Un PDF tiene páginas, y las páginas tienen bordes. La mayoría de los conversores ignoran esa diferencia: entregan el archivo a un navegador, pulsan imprimir y devuelven lo que salga. Por eso una tabla pierde sus últimas cuatro columnas, un encabezado termina aislado al pie de una página y el logo en la parte superior de un README aparece como una línea de HTML sin procesar impresa como texto. Este conversor primero adapta el documento al papel y luego te informa de lo que tuvo que hacer para lograrlo.
Tablas que siguen cabiendo en el papel
Una tabla en Markdown no lleva anchos de columna. La sintaxis no tiene dónde ponerlos, así que un conversor que pasa la tabla directamente a un navegador solo espera que encaje. Aquí, cada tabla se mide antes de dibujarla y se ajusta al papel que elegiste. Una tabla de rutas de archivos con catorce columnas sigue quedando dentro de los márgenes, con los valores largos ajustándose en varias líneas en vez de salirse del borde, y el resultado indica que fue necesario hacerlo así.
La parte menos visible del problema ocurre en la segunda página. Una tabla larga suele dejar su fila de encabezado atrás en la primera página, así que el lector se encuentra con una cuadrícula de números sin etiquetas. Aquí, el encabezado se repite en cada página que ocupa la tabla y nunca se corta una fila por un salto de página.
Código que sobrevive al margen
El código entre vallas mantiene su resaltado y la etiqueta de su lenguaje. Las líneas largas se ajustan para que puedas ver que se han partido, en vez de cortarse donde termina el papel. Un PDF no tiene barra de desplazamiento, así que una línea que no se ajusta es una línea con su lado derecho perdido. Los bloques indentados, las vallas sin lenguaje y el código en línea también se conservan tal cual son.
Las imágenes de tu README
Un logo y una fila de insignias de compilación casi nunca se escriben en Markdown. No hay forma de centrar una imagen en Markdown, así que los archivos README recurren al HTML sin procesar. Un conversor que se niega a renderizar HTML normalmente lo escapa en vez de omitirlo, lo que significa que el documento se abre con una pantalla llena de etiquetas de imagen impresas como texto. Aquí se elimina el marcado y se conservan las imágenes y las palabras dentro de él, así que la parte superior del documento se ve como debería.
Las imágenes se descargan y se incrustan en el archivo en vez de enlazarlas, así que el PDF sigue funcionando sin conexión y dentro de un año. Si alguna no puede descargarse, el resultado la cuenta y lo indica en vez de dejar un hueco en silencio donde debería haber una imagen.
Tus encabezados se convierten en la navegación
Cada PDF lleva un árbol de marcadores construido a partir de tus propios encabezados, para que puedas navegar un documento largo desde la barra lateral en vez de desplazarte. Si pides una página de contenido, obtienes una interactiva, al nivel de encabezado que elijas. Un solo encabezado en la parte superior se interpreta como el título del documento y se omite de la lista, igual que el título de un libro y no de un capítulo.
Las notas al pie siguen siendo notas al pie, con un marcador elevado y un enlace de vuelta a la línea que estabas leyendo. Las listas de tareas mantienen sus casillas, marcadas y sin marcar. Los avisos de nota, advertencia y consejo conservan su barra de color. El front matter al principio del archivo se trata como metadatos y no aparece en la página. Las listas de definiciones, el tachado, las citas anidadas y hasta tres niveles de listas anidadas se representan tal cual.
Te dice lo que no pudo hacer
Cada conversión viene acompañada de un breve informe: cuántas páginas, en qué dirección va el texto, cuántas tablas, cuántos bloques de código, cuántas imágenes se incrustaron y cuántas no se pudieron descargar. Si a una fuente le faltaba un carácter, lo lista. Si pediste una página de contenido y el documento no tiene encabezados para mostrar, lo indica en vez de entregarte un archivo con una página en blanco al principio. Un conversor que oculta sus propios fallos es la razón por la que la gente deja de confiar en ellos.
Escrituras que no son latinas
Las fuentes viajan dentro del PDF, así que un documento se abre igual en una máquina que no tenga ninguna instalada. El texto de derecha a izquierda se evalúa bloque por bloque en vez de una sola vez para todo el archivo, lo cual es importante porque un documento técnico en ese tipo de escritura suele ser mitad latino por número de caracteres, lleno de rutas de archivo y nombres de clase, y aun así se lee de derecha a izquierda. El código entre vallas se excluye de esa decisión y siempre se muestra de izquierda a derecha, y el resto del diseño se invierte correctamente: viñetas, barras de cita y columnas de tabla se adaptan. Cuando una escritura no tiene cursiva, el énfasis se marca con peso en vez de inclinar letras que nunca fueron dibujadas para inclinarse.
Lo que no hará
No se renderiza LaTeX. Un bloque entre signos de dólar se imprime tal cual como texto. Tampoco se dibuja Mermaid: una valla marcada como mermaid aparece como un bloque de código con etiqueta. El chino, japonés y coreano quedan fuera de las fuentes que lleva la herramienta, así que los caracteres en esos sistemas se informan como ausentes en vez de intentar adivinarlos. Son límites, no defectos, y se indican aquí para que nadie los descubra después de subir su archivo.
La parte práctica
Sube desde tu dispositivo, desde Google Drive o pegando un enlace a un archivo. Se aceptan archivos Markdown con cualquiera de sus extensiones habituales, y también texto plano. El papel puede ser A3, A4, A5, Carta, Legal o Tabloide, en vertical u horizontal, con márgenes estrechos, normales o anchos. La numeración de páginas y el resaltado de sintaxis están activados salvo que los desactives. Envía un archivo y recibirás un PDF; envía varios y llegarán en un ZIP, o como un solo PDF fusionado con numeración continua de páginas si así lo pides. El texto sigue siendo texto real, así que se puede seleccionar, buscar y copiar, en vez de quedar aplanado como una imagen de palabras.
Lo que obtienes
- Tablas que permanecen dentro de los márgenes, con la fila de encabezado repetida en cada página que ocupan
- Código resaltado con líneas largas ajustadas en vez de cortadas
- Imágenes incrustadas en el archivo, incluidas las escritas en HTML sin procesar
- Un árbol de marcadores a partir de tus encabezados y una página de contenido interactiva cuando la quieras
- Fuentes incluidas dentro del PDF, para que el archivo se vea igual en cualquier equipo
- Un informe escrito de todo lo que el conversor no pudo hacer, incluidos glifos e imágenes ausentes
¿Qué sigue?
¿Trabajando desde un archivo Word? Word a PDF sigue el mismo camino hasta el papel. Reúne el resultado con el resto de tu informe usando Unir PDF. Luego reduce el tamaño del archivo antes de enviarlo con Comprimir PDF.