Imprime Markdown con elegancia

La forma más rápida de probar mdprint es empezar a escribir en el editor de la página de inicio. Se carga con un documento de muestra que ejercita cada función - tablas, código, matemáticas, diagramas - para que veas de inmediato cómo es una página terminada. Borra la muestra y escribe tu propio contenido, o pégalo desde donde lo hayas escrito.

Si ya tienes un archivo Markdown en tu ordenador, tienes dos formas de cargarlo. La primera es arrastrarlo desde tu gestor de archivos y soltarlo en el panel del editor. Aparecerá un resalte alrededor de la zona de soltado mientras arrastras. Suelta el archivo y el editor se llena con su contenido. La segunda es hacer clic en el botón Importar de la barra de herramientas y seleccionar el archivo en el selector. Ambos métodos leen el archivo localmente - nada se sube.

mdprint acepta archivos .md, .markdown y .txt. La extensión .txt es útil para documentos escritos en Markdown pero guardados con una extensión genérica por otra herramienta. Si intentas importar un archivo con otra extensión, mdprint mostrará un error y dejará tu contenido actual intacto.

Si nunca has escrito Markdown, las reglas son lo bastante pocas para aprenderlas en cinco minutos. Escribes texto plano y cuatro caracteres hacen la mayor parte del trabajo. El símbolo # al inicio de una línea crea un título - un # para el más grande, seis ###### para el más pequeño. Los símbolos * y _ alrededor de una palabra la ponen en cursiva con uno a cada lado y en negrita con dos. El símbolo - o * al inicio de una línea crea una viñeta. Indenta dos espacios para anidar una viñeta bajo otra.

El código se maneja con comillas invertidas. Una comilla invertida a cada lado de una frase la formatea como `código en línea`. Tres comillas invertidas en una línea inician un bloque de código y tres más lo cierran. Si pones un nombre de lenguaje justo después de las tres comillas invertidas de apertura (```python, ```typescript, ```sql), el bloque obtiene resaltado en ese lenguaje. Sin pista de lenguaje, el resaltador intenta adivinar a partir del contenido, lo que suele funcionar con lenguajes populares.

Los enlaces e imágenes usan corchetes y paréntesis. Un enlace es [el texto que se ve](la URL). Una imagen es lo mismo con un signo de exclamación delante: . Cuando imprimes a PDF, las URLs de imágenes que apuntan a servidores de acceso público se recogen e incrustan. Las imágenes en tu máquina local o detrás de autenticación no se renderizarán - suéltalas directamente en el editor como URLs data base64 si las necesitas en línea.

Las tablas son la única parte de Markdown que parece quisquillosa en la fuente pero se renderiza limpiamente. Una fila de cabecera, una fila separadora de guiones y una o más filas de datos, todas separadas por barras. Las columnas no tienen que estar alineadas en la fuente - el renderizador se encarga del espaciado. Añade dos puntos a uno o ambos extremos de los guiones en la fila separadora para controlar la alineación: :--- para izquierda, ---: para derecha, :---: para centrado.

Las ecuaciones matemáticas usan sintaxis TeX entre signos de dólar. Un dólar simple a cada lado te da matemáticas en línea: $a^2 + b^2 = c^2$. Dos dólares en líneas propias te dan una ecuación en display, centrada en su propia línea y más grande. Todos los comandos matemáticos LaTeX que esperarías - \frac, \int, \sum, \sqrt, letras griegas, matrices, el conjunto AMS - funcionan porque mdprint usa KaTeX, que implementa la misma sintaxis.

Los diagramas usan sintaxis Mermaid dentro de un bloque de código vallado etiquetado con el lenguaje mermaid. El diagrama más simple es un flujo: abre con graph LR (izquierda a derecha) o graph TD (de arriba a abajo), luego escribe nodos conectados por flechas. Mermaid también admite diagramas de secuencia (flujo de mensajes entre actores en el tiempo), diagramas de Gantt (cronogramas de proyecto con dependencias), diagramas de clases (relaciones entre objetos) y diagramas de estado (máquinas de estados). La documentación de Mermaid tiene ejemplos para cada tipo.

Las notas al pie te permiten mantener la prosa legible mientras adjuntas citas detalladas o digresiones. Marca una nota en tu texto con [^1] (el número puede ser cualquiera - se renumeran en la salida). En otro lugar del documento, define la nota con [^1]: el contenido de la nota. mdprint recoge todas las notas al final del documento impreso y añade referencias inversas que enlazan cada nota con el lugar donde aparece en el texto.

Si tu documento es largo, deja el texto literal [[toc]] en la fuente donde quieras que aparezca un índice. mdprint lo reemplaza por una lista anidada de enlaces a cada H2 y H3 del documento. En el PDF impreso, ese mismo índice se convierte en un esquema de navegación que pueden usar los lectores de PDF.

Abre el panel de Ajustes desde la barra de herramientas para controlar cómo se genera tu PDF. El tamaño de página tiene dos opciones: A4 (el estándar fuera de Norteamérica) o Letter (el estándar en Norteamérica). La orientación alterna entre vertical y horizontal - horizontal es útil para documentos con tablas o diagramas anchos. Los márgenes ofrecen tres preajustes: estrechos te dan más superficie útil para contenido denso, normales son el término medio convencional, y amplios dejan espacio para anotaciones manuscritas en una copia impresa.

El editor tiene sus propios temas claro y oscuro, independientes del resto de la página. El conmutador de la barra de herramientas cambia entre ambos. La vista previa y la salida impresa permanecen en modo claro siempre, porque los fondos claros son los que mejor se imprimen en papel.

Si usas regularmente el mismo conjunto de opciones, tu última selección se recuerda localmente y se aplica automáticamente la próxima vez que abras mdprint en el mismo navegador.

El botón Imprimir abre el diálogo de impresión nativo de tu navegador. Desde ahí, todo sistema operativo moderno ofrece Guardar como PDF como destino - Chrome, Firefox, Safari y Edge lo admiten en macOS, Windows y Linux. Pasar por el diálogo de impresión da el máximo control: puedes elegir cualquier impresora, previsualizar cada página, cambiar la orientación por página si tu controlador lo permite, y en algunas impresoras puedes cambiar bandejas de papel o grapado.

El botón Descargar PDF se salta el diálogo de impresión y genera un archivo PDF directamente en el navegador, luego activa una descarga. Usa tus Ajustes actuales (tamaño de página, orientación, márgenes) para formatear la salida. Esta ruta es más rápida cuando sabes exactamente lo que quieres y no necesitas la flexibilidad del diálogo de impresión. Funciona renderizando la página como una imagen de alta resolución y colocando esa imagen en el PDF, así que el resultado siempre coincide con lo que ves en pantalla. La contrapartida: como la página se convierte en imagen, el texto de este PDF no es seleccionable ni se puede buscar.

Las dos rutas difieren en lo que acaba dentro del archivo. Guardar como PDF, mediante el botón Imprimir, mantiene el texto como texto: sigue siendo seleccionable y localizable, se ve nítido con cualquier zoom y los diagramas se conservan como vectores. Descargar PDF es, en cambio, una instantánea de imagen con un clic, así que es rápida y exacta al píxel, pero el texto no es seleccionable. Usa Guardar como PDF cuando quieras texto seleccionable o el resultado más nítido a cualquier zoom; usa Descargar PDF cuando solo quieras una copia rápida y exacta de lo que hay en pantalla sin abrir el diálogo de impresión.

Saltos de página en lugares incómodos. mdprint evita romper dentro de bloques de código, tablas y diagramas, pero no adivina en la prosa. Si un título termina al pie de una página y el contenido de la sección en la siguiente, la solución más fácil es añadir unas frases antes o después para desplazar el título. No hay sintaxis manual de salto de página en V1 - añadirla está en la lista V2.

Las imágenes no aparecen en el PDF. La causa más común es una URL de imagen que apunta a tu sistema de archivos local (file://) o a un servidor que no permite acceso cross-origin. O bien incrusta la imagen como URL data directamente en la fuente Markdown, o súbela a un alojamiento de imágenes que permita lectura pública. Imgur, los servidores user-content de GitHub y la mayoría de CDNs funcionan.

Las matemáticas no se renderizan. Revisa la fuente por signos de dólar sin escapar en texto normal - un $ extraviado puede iniciar una zona matemática que se traga el resto del párrafo. Si necesitas un signo de dólar literal en la prosa, escápalo: \$. Si la sintaxis matemática es correcta pero la ecuación sigue sin renderizarse, el comando LaTeX puede no estar en la lista soportada de KaTeX - la documentación de KaTeX tiene una referencia completa.

El diagrama sale en blanco. Mermaid es estricto con la sintaxis. Los errores más comunes son un espacio faltante tras graph LR, un identificador de nodo con un espacio (usa camelCase o guiones bajos), o una flecha que apunta a un nodo no definido. Abre la consola de desarrollador del navegador - Mermaid registra un mensaje de error específico cuando falla el análisis.

Las tablas se ajustan raro. Si una tabla es más ancha que la página, mdprint la reduce para que encaje. Para tablas muy anchas, cambia a orientación horizontal en Ajustes, o reestructura la tabla como lista. PDF no maneja el desplazamiento horizontal como lo hace la web.

Usa los atajos de teclado. Cmd+P (o Ctrl+P en Windows y Linux) abre el diálogo de impresión. Cmd+S (Ctrl+S) activa Descargar PDF. Los propios atajos del navegador para buscar (Cmd+F), recargar (Cmd+R) y zoom (Cmd+más/menos) funcionan con normalidad - no entran en conflicto con mdprint.

Empieza cada documento con un H1. El primer H1 se convierte en el nombre de archivo PDF sugerido, en el título del documento para accesibilidad y en el título destacado de la parte superior de la página impresa. Si empiezas con H2 o inferior, el nombre de archivo cae a 'document.pdf' y tendrás que renombrarlo manualmente tras la descarga.

Incrusta imágenes como URLs data cuando la privacidad importe. Si no quieres que un lector de PDF traiga imágenes desde un servidor remoto al abrir tu archivo, convierte la imagen a una URL data base64 e incrústala directamente. La mayoría de los sistemas operativos tienen una herramienta integrada o específica para esta conversión. El archivo resultante es más grande, pero totalmente autocontenido.

Usa listas de tareas para listas de verificación impresas. Si produces una lista de comprobación en papel - una lista de equipaje, una lista de envío, un procedimiento paso a paso - usa la sintaxis de listas de tareas de Markdown con - [ ]. Las casillas se imprimen como cuadrados que puedes marcar con un bolígrafo.

Combina mermaid y código en documentación técnica. Un patrón habitual es mostrar un diagrama de flujo de un proceso, seguido del código real que lo implementa. Markdown te permite ambos en el mismo archivo y mdprint los renderiza de forma que se imprimen limpiamente lado a lado.

Cmd+P o Ctrl+P - abrir el diálogo de impresión.

Cmd+S o Ctrl+S - descargar como PDF.

Cmd+B o Ctrl+B dentro del editor - poner en negrita el texto seleccionado.

Cmd+I o Ctrl+I dentro del editor - poner en cursiva el texto seleccionado.

Cmd+/ o Ctrl+/ dentro del editor - alternar comentario para la línea actual (comentario HTML en contexto Markdown).

Esc dentro del editor en pantalla completa - salir de pantalla completa.