Convertir MD a PDF

Esta es la diferencia con cualquier otra conversión de documentos del sitio. Un archivo de Word conoce su tamaño de página, sus márgenes y sus tipografías; un archivo Markdown no conoce ninguna de las tres, porque el formato registra estructura a propósito y deja la apariencia a lo que sea que lo represente.

De modo que todas las decisiones sobre la página —su tamaño, sus márgenes, la letra, dónde cae un salto— las toma el conversor y ninguna está en tu archivo. Ese es el trato que hace Markdown y normalmente es bueno: el mismo documento se vuelve página web, presentación y PDF sin reescribirse. El coste aparece aquí, donde el motor que compone no ha sido dotado de un lector de Markdown y se limita a componer los caracteres.

Todos los caracteres del archivo llegan a la página, en orden y con una sola tipografía. Una línea que dice ## Requisitos se compone como ## Requisitos. Una viñeta escrita con un guion es una línea que empieza por un guion. Un bloque de código conserva sus tres acentos graves arriba y abajo. La negrita conserva sus cuatro asteriscos. No se descarta nada y no se interpreta nada.

Conviene ser preciso sobre lo que sí queda. Los saltos de línea, las líneas en blanco y la sangría se conservan exactamente, así que un documento cuyo valor son sus comandos y su configuración se convierte en algo utilizable. Un documento cuyo valor es su jerarquía de títulos no. Para ese caso, representa el Markdown en la herramienta donde lo escribiste e imprime el PDF desde ahí: esta conversión sirve para fijar el texto de un archivo, no para maquetarlo.

Detrás de esta pareja hay una suite ofimática completa ejecutándose en un contenedor, la misma que convierte los DOCX y los ODT del sitio, y a ella se le pasa el archivo tal cual con la orden de producir un PDF. Esa suite no tiene filtro de importación de Markdown, y el contenedor no instala ninguna herramienta de documentación que pudiera hacer ese trabajo antes.

Así que no hay una casilla escondida ni un modo avanzado. Esta página anunció durante un tiempo que los títulos se convertían en títulos y las listas conservaban su anidamiento, y era falso: nada en el recorrido podía hacerlo. Preferimos decir lo que ocurre y dejar que decidas si te sirve.

Un documento Markdown que enseña seis diagramas no contiene ningún diagrama. Contiene seis rutas, y las imágenes viven al lado en el disco o en un servidor. Es la sorpresa más común de la primera conversión y el motivo habitual de que el PDF llegue con huecos.

Aquí ni siquiera se intenta seguir esas rutas: la referencia se imprime como se escribió, con su signo de exclamación, su texto alternativo entre corchetes y su ruta entre paréntesis. Si los diagramas son el contenido del documento, este no es el camino; represéntalo donde lo escribiste y exporta desde ahí.

Muchísimos archivos Markdown empiezan con un bloque delimitado por tres guiones que contiene un título, una fecha y unas etiquetas. Los generadores de sitios estáticos, los constructores de documentación y las aplicaciones de notas lo leen como metadatos y lo eliminan antes de representar nada.

Esta conversión no conoce el convenio e imprime el bloque como todo lo demás, así que el PDF empieza con tres guiones y una lista de pares clave-valor antes de que arranque el documento. Borrar el bloque antes de convertir es el arreglo completo, y conviene hacerlo sobre una copia para que el original siga funcionando en la herramienta que lo escribió.

Normalmente la pregunta que decide cómo sale un documento es qué extensiones implementa la herramienta: las tablas con barras verticales, las listas de tareas, las notas al pie y el tachado son añadidos sobre la especificación común, y cada programa admite un subconjunto distinto.

En esta página esa pregunta no existe. Aquí no se implementa ninguna extensión, ni el núcleo tampoco, así que una tabla y un título reciben el mismo trato: líneas de texto. Al menos es predecible —no hay variante que adivinar ni motor contra el que probar— y lo que ves en tu editor con el resaltado apagado es exactamente lo que va a contener el PDF.

El contenedor que hace la conversión instala las familias tipográficas Liberation y Liberation 2, Carlito, Caladea, DejaVu Core, Noto Core y Noto CJK. Entre todas cubren de sobra el alfabeto latino con acentos, la eñe, la diéresis, los signos de apertura de interrogación y exclamación y el símbolo del euro, así que un texto en castellano, catalán, gallego o portugués se compone sin sustituciones raras.

Donde sí hay que mirar es en la codificación del archivo de origen. Un .md guardado hace años en una codificación regional de un solo byte y no en UTF-8 llega con las tildes rotas, y lo que se imprime son los caracteres rotos: la conversión reproduce fielmente lo que recibe. Abrir el archivo en un editor y volver a guardarlo como UTF-8 antes de subirlo resuelve el caso entero.

Casi todo en este sitio ocurre en tu navegador. Esta pareja no: necesita una suite ofimática de verdad, y eso no cabe en una pestaña. El archivo viaja por una conexión cifrada a nuestra interfaz de conversión, se guarda en un directorio de trabajo recién creado y se escribe ahí con un nombre genérico, de modo que el nombre de tu archivo no llega a tocar el disco.

Ese directorio se elimina cuando el trabajo termina, y la eliminación está en el bloque que se ejecuta también en cada camino de error, no solo cuando todo sale bien. El contenedor donde corre la suite no tiene salida a internet, y el resultado se devuelve con la cabecera que impide que ninguna caché intermedia lo guarde.

El límite de esta conversión es de 25 MB por archivo, porque corre en nuestro servidor. Las conversiones que ocurren en el navegador admiten 100 MB, y ese es el número que la zona de soltar comprueba en todos los casos, sin mirar de qué lado corre la pareja.

La consecuencia hay que decirla en lugar de ocultarla: un archivo de 40 MB es aceptado por la interfaz y rechazado después por la conversión, con un mensaje que explica el límite. Para un Markdown, que es texto plano, ese caso es casi imposible de provocar salvo que hayas pegado un volcado enorme dentro. Aun así, es un defecto conocido de la interfaz y no una trampa.

Las conversiones de servidor tienen un recuento: cien por visitante y día, con la ventana medida en día UTC, así que se reinicia a medianoche en horario universal y no a la medianoche de Madrid, Bogotá o Buenos Aires. Hay además un tope de ráfaga de cinco peticiones en sesenta segundos, pensado contra el uso automatizado y no contra una persona convirtiendo documentos.

Ese contador solo se aplica a las parejas de servidor. Una conversión que corre en tu navegador no nos cuesta capacidad y no se cuenta: no hay cuenta de usuario, ni marca de agua, ni límite por visitante en el lado del navegador. Es un único plan y es gratuito.

Cada programa que se lanza en el servidor se interrumpe a los sesenta segundos. Conviene decirlo con precisión porque la frase habitual —«las conversiones caducan al minuto»— no es correcta: el límite es por proceso, y una conversión que encadene varios pasos puede legítimamente ocupar más tiempo total del que marca ese número.

Para un Markdown eso no se roza nunca. El trabajo se reduce a arrancar la suite, componer texto plano y escribir el PDF, que en un documento de unos cuantos miles de palabras se resuelve en segundos. El límite existe porque otros formatos de esta misma vía sí pueden atascarse con entradas malformadas.

Si lo que necesitas entregar es un documento presentable —una memoria técnica, una propuesta para un cliente, una entrega con títulos, tablas y figuras— esta conversión no te lo va a dar, y decirlo es más útil que dejarte descubrirlo al abrir el PDF. Compón el Markdown donde lo escribes y exporta el PDF desde allí.

Donde sí encaja es en fijar un texto tal cual está: un fichero de configuración comentado, unas instrucciones de despliegue, unas notas de reunión que alguien tiene que firmar o archivar, un anexo del que interesa que quede constancia del día. Un PDF congela el estado, y eso es exactamente lo que pide una revisión, una entrega o un anexo contractual.