Convertir un archivo Markdown a PDF

Cómo funciona

Toque o haga clic en el recuadro y elija su archivo Markdown; se aceptan las extensiones .md, .markdown y .txt. La herramienta lee el archivo con las reglas GFM que usa GitHub: las líneas que empiezan con # se vuelven títulos y crecen según el nivel; las que empiezan con - o con 1. forman listas con viñetas o numeradas (las listas anidadas se sangran); el código entre tres acentos graves se escribe en un recuadro gris respetando cada línea; las tablas hechas con | se reparten en columnas iguales y la fila de encabezado se separa con fondo gris; las citas con > se sangran y --- se convierte en una línea horizontal. La negrita y la cursiva se conservan como texto, pero no se dibujan con otra tipografía; los enlaces se escriben como «texto (dirección)» para que también se puedan leer en papel. Ejemplo: un README de 40 líneas con 3 títulos y una lista de 12 elementos cabe en 2 páginas A4, y la línea de resultado indica «2 páginas · 3 títulos, 6 párrafos, 12 elementos de lista, 1 tablas». Las imágenes no se cargan: en su lugar aparece el texto alternativo entre corchetes y la línea de resultado dice cuántas se escribieron así. El papel por omisión en esta página es A4; si usted está en México o en otro país que usa papel carta, elija «Carta (Letter)». Su archivo no sale de su dispositivo.

Esta herramienta también se busca como markdown a pdf, convertir md a pdf, md a pdf, readme a pdf, convertir markdown a pdf gratis, markdown a pdf online, exportar markdown a pdf.

¿Qué es Markdown?

Markdown es una forma de dar formato a un archivo de texto plano con unos pocos signos: un # al inicio de la línea crea un título, un guion crea un elemento de lista y dos asteriscos alrededor de una palabra la ponen en negrita. Así se escriben los README de GitHub, las notas de Obsidian y Notion, la documentación de software y muchos blogs; la extensión es .md. No hace falta ningún programa especial para escribirlo, pero quien abre un .md en el teléfono ve los signos tal cual. Esta herramienta convierte esos signos en un diseño de página y produce un PDF que cualquiera puede abrir e imprimir sin instalar nada.

¿Qué es GFM (GitHub Flavored Markdown)?

GFM es el conjunto de reglas que GitHub añadió al Markdown original y que hoy casi todos los editores tratan como estándar: las tablas con |, las listas de tareas con - [ ], el texto tachado entre dos virgulillas y los bloques de código abiertos con tres acentos graves vienen de ahí. Esta herramienta lee el archivo con las reglas GFM; la tabla de su README se vuelve una tabla en el PDF y la lista de tareas se escribe con las marcas [x] y [ ]. Si su editor usa otro dialecto, por ejemplo la sintaxis de una wiki, esos signos pasan al PDF como texto normal.

¿Cuál es la diferencia entre Markdown y PDF?

Markdown es un formato de origen, el que se usa mientras se escribe: pequeño, editable y cómodo para el control de versiones, pero su aspecto depende del programa que lo abre y no tiene páginas. El PDF es el formato de resultado: la medida del papel, los márgenes y el orden de las páginas van dentro del archivo, se ve igual en todos los dispositivos, se imprime y se adjunta a un correo. Esta herramienta es un puente de un solo sentido: convierte la estructura del .md en un diseño de página y escribe el texto de forma seleccionable. Para volver de PDF a Markdown tendría que extraer el texto con la herramienta de extraer texto de PDF y añadir los signos a mano.

¿Qué pasa al diseño de página y qué queda como texto plano?

Pasa al diseño: los seis niveles de título (por tamaño y grosor), las listas con viñetas y numeradas (cada nivel anidado se sangra 18 puntos), las listas de tareas ([x] y [ ]), los bloques de código (recuadro gris; se respetan saltos de línea y espacios), las tablas (columnas de igual ancho, las celdas largas se parten en varias líneas, encabezado en gris), las citas (sangría) y las líneas horizontales. Como solo se incrusta una tipografía, la negrita y la cursiva no se dibujan aparte: el texto se conserva y los asteriscos y guiones bajos desaparecen.

Queda como texto plano: el código en línea (entre acentos graves) se escribe con la letra normal; los enlaces se convierten en «texto (dirección)» para que se puedan leer en papel; las etiquetas HTML sueltas se eliminan y su texto se conserva. Las imágenes no se cargan: la herramienta no sale a la red y no puede abrir una ruta relativa de su dispositivo, así que en su lugar escribe «[imagen: texto alternativo]» y la línea de resultado indica cuántas se escribieron así. Si el documento necesita sus imágenes, genere el PDF y añádalas con un editor de PDF, o convierta antes el documento a HTML.

¿Qué ajuste conviene en cada caso?

El tamaño de papel por omisión sigue el idioma de la página: en esta página en español es A4, igual que en las páginas en alemán y francés, mientras que la página en inglés elige Carta. Si usted está en México, Estados Unidos o en otro país que imprime en papel carta, elija «Carta (Letter)» a mano; la diferencia (21,6 × 27,9 cm frente a 21 × 29,7 cm) cambia el corte de las páginas. El tamaño de letra se aplica al texto del cuerpo y los títulos crecen en proporción: 11 puntos es el tamaño de lectura habitual; 10 puntos mete un documento largo en menos páginas; 12 puntos es cómodo para leer en pantalla o para una persona mayor. Los bloques de código se escriben 1,5 puntos más pequeños que el cuerpo y las celdas de tabla, 1 punto más pequeñas.

Si el documento lleva una tabla muy ancha, las columnas se estrechan y el texto de las celdas se parte; con más de ocho columnas una tabla puede dejar de leerse bien en A4 vertical, y conviene dividirla en el propio documento. Para las tildes, la eñe y los signos ¿ y ¡ se incrusta un subconjunto de Noto Sans en el PDF; si esa tipografía no se pudiera cargar, la herramienta pasa a la tipografía estándar, escribe esas letras con su equivalente ASCII y lo indica en la línea de resultado. En ese caso, recargar la página y volver a intentarlo suele bastar.

Preguntas frecuentes

¿Cómo convierto un README.md a PDF?

Elija el archivo en el recuadro y pulse «Convertir a PDF»; no hace falta ningún otro ajuste. Los títulos, las listas, las tablas y los bloques de código pasan al diseño de página y el texto sigue siendo seleccionable. Si selecciona varios archivos .md, cada uno se descarga como un PDF con su propio nombre; para reunirlos en un solo documento, pase los archivos descargados por la herramienta de unir PDF.

¿Las tablas de Markdown se ven en el PDF?

Sí. Las tablas GFM hechas con | se reparten en columnas de igual ancho, la fila de encabezado se separa con fondo gris y el texto largo de una celda se parte en varias líneas dentro de su celda; una fila que cae al final de la página no se corta, pasa entera a la siguiente. Como el ancho de las columnas se reparte por igual y no según el contenido, en una tabla con muchas columnas la letra se estrecha.

¿Por qué la negrita y la cursiva salen como texto normal en el PDF?

En el PDF se incrusta una sola tipografía; la negrita y la cursiva necesitarían archivos de tipografía aparte y eso duplicaría los datos que carga la página. Los signos de énfasis (asteriscos, guiones bajos) desaparecen y el texto se conserva; los títulos sí se distinguen por tamaño y grosor. Si necesita conservar el énfasis, convierta antes el documento a HTML y guárdelo como PDF desde el menú de imprimir del navegador.

¿Mi archivo se sube a algún servidor?

No. Su archivo Markdown no sale de su dispositivo: la lectura del archivo, la interpretación de los signos y la escritura del PDF ocurren por completo dentro de su navegador. Eso importa con documentación de software sin publicar o con notas personales; con la página ya abierta, la conversión funciona incluso sin conexión a Internet.