Acerca de la herramienta Markdown a PDF
Markdown es cómodo de escribir, pero alguien que no es desarrollador prefiere recibir un documento antes que un archivo lleno de almohadillas y asteriscos. Esta herramienta analiza tu Markdown con marked, una biblioteca de código abierto con licencia MIT, siguiendo la especificación CommonMark más dos añadidos de GitHub: las tablas y el tachado. Después, el documento analizado se compone en páginas carta (Letter) o A4 con un único estilo, fácil de leer.
Elementos que salen con formato
- Títulos, párrafos, negrita, cursiva y tachado
- Código en línea y bloques de código delimitados, compuestos en una fuente monoespaciada sobre fondo sombreado
- Listas con viñetas, numeradas y anidadas
- Citas en bloque y líneas horizontales
- Tablas, dibujadas como una cuadrícula sencilla
- Enlaces, que siguen siendo clicables en el PDF
El aspecto es fijo: no hay temas ni forma de aplicar tu propio CSS. Lo que puedes controlar son dos cosas: el tamaño del papel y el tamaño de fuente base. Así la herramienta es rápida de usar y el resultado es coherente, algo que encaja mejor con apuntes, documentación e informes que con folletos de diseño.
Cómo usar la herramienta Markdown a PDF
- Abre tu archivo .mdSelecciona un archivo Markdown o arrástralo a la herramienta. Sirven las exportaciones de apps de notas, wikis y repositorios de código, siempre que usen la sintaxis Markdown estándar.
- Elige el papel y el tamaño de fuente baseEn «Tamaño de página», elige «Carta (Letter, 8,5 × 11 in)» o «A4», y luego el «Tamaño de fuente» base para el cuerpo del texto. Con un tamaño más pequeño cabe en la página una mayor parte de una tabla ancha o de una línea de código larga.
- Genera el PDF y descárgaloPulsa «Crear PDF» y guarda el archivo. Ábrelo una vez para revisar los títulos, las tablas y los posibles marcadores de imagen antes de enviarlo.
Cuándo se usa
Un README para alguien ajeno al repositorio
Las notas de instalación de un proyecto escritas en Markdown pueden llegar a un cliente o a tu responsable como un PDF que se abre en cualquier parte, con los pasos de instalación en listas numeradas y los comandos en bloques de código sombreados.
Notas de reunión convertidas en un documento para repartir
Unas notas tomadas deprisa en Markdown, con un título por tema, viñetas para las decisiones y una pequeña tabla de responsables y fechas, se convierten en una página imprimible para la siguiente reunión.
Trabajos de clase redactados en un editor de texto plano
La plataforma del curso solo acepta PDF, pero tú escribes en Markdown. Convierte el archivo final y sube un documento cuyos títulos, citas y enlaces a fuentes conservan el formato.
Por qué las imágenes aparecen como marcadores
Markdown hace referencia a las imágenes mediante una ruta o una dirección web, por ejemplo . Esta página no carga archivos de fuera del sitio, así que las imágenes referenciadas no se descargan. En su lugar, el PDF muestra un marcador con el texto [image: texto alternativo], que usa la descripción escrita entre corchetes, para que quien lo lea sepa que ahí iba una imagen. Por eso merece la pena escribir textos alternativos con sentido en tu Markdown.
Cuando las imágenes importan, crea un PDF con ellas mediante JPG a PDF o PNG a PDF y combínalo con el texto generado usando Unir PDF.
Idiomas y las fuentes que los acompañan
El español, el inglés y los demás idiomas que se escriben con alfabeto latino usan Helvetica y Courier, fuentes estándar que ya tiene cualquier lector de PDF, así que no hace falta incrustar nada. El griego y el cirílico se componen en Roboto, y el chino y el japonés en Droid Sans Fallback; ambas fuentes tienen licencia Apache-2.0 y se incrustan como subconjuntos que solo contienen los caracteres que usa tu documento. La fuente CJK es una descarga de unos 4 MB que tu navegador solo obtiene cuando el Markdown contiene realmente esos caracteres.
El hangul coreano no está cubierto por ninguna de las dos fuentes y sale como signos de interrogación. El árabe, el hebreo y otras escrituras de derecha a izquierda, así como escrituras complejas como el hindi y el tailandés, no se maquetan correctamente. Para documentos en esos idiomas, un procesador de textos o un navegador que los admita es mejor camino hacia el PDF.
Calidad y tamaño del resultado
Todo el texto del PDF es texto vectorial: nítido con cualquier zoom, con posibilidad de búsqueda y de copia. Como no se incrustan imágenes y las fuentes van en subconjuntos, un documento Markdown típico produce un archivo ligero, fácil de enviar por correo. Los enlaces siguen funcionando en los visores que los admiten. Si necesitas una copia impresa con números de página, pasa el resultado por Numerar páginas de PDF.
Sintaxis que no se representa
- Imágenes, que se convierten en marcadores como se explica arriba.
- Estilos propios: CSS personalizado, temas, colores y elección de fuentes.
- Extensiones fuera de CommonMark, salvo las tablas y el tachado de GitHub. Las notas al pie, las fórmulas matemáticas y los diagramas escritos como código no forman parte de ese conjunto, así que verás su texto fuente en lugar de un resultado representado.
- Archivos de texto plano. Si tu archivo no es realmente Markdown, TXT a PDF conserva cada línea y cada espacio tal como se escribieron.
Tanto el análisis como la maquetación de las páginas se ejecutan en esta pestaña del navegador; el Markdown y el PDF resultante se quedan en tu dispositivo. Así puedes confirmarlo.