MarsDawn
Entrégales el PDF, no el Markdown.
Un agente termina un documento, tú lo revisas y lo corriges, y luego alguien fuera del equipo técnico también tiene que leerlo: un gerente, un cliente, alguien de otro equipo. No necesitan saber qué significa ## ni una tabla con barras verticales. Exporta a PDF y entrégales eso.
Exporta el documento revisado a PDF y envía ese archivo. Se abre en cualquier lado, no requiere saber Markdown ni instalar nada, y se ve como lo viste en la vista previa, con diagramas, tablas y formato incluidos.
Por qué no enviar simplemente el archivo .md
Un archivo .md sin procesar, abierto en un editor de texto plano, muestra las marcas, no la página: # para un título, ** alrededor de la negrita, un bloque delimitado para un diagrama Mermaid que no se dibuja. Alguien que no escribe Markdown no lee nada de eso como se pensó, y pedirle que primero instale un visor es mucho pedir para un solo documento.
Por qué no una captura de pantalla
Una captura congela una pantalla de un documento que puede tener varias páginas, no se puede buscar ni seleccionar, y se lee peor después de comprimirla y reenviarla unas cuantas veces. Un PDF conserva intactos el texto, los diagramas y los saltos de página, sin importar la extensión.
Lo que te da un PDF
- Se abre con lo que la otra persona ya tiene, Vista Previa, un navegador, Acrobat, su teléfono, sin necesidad de una herramienta de Markdown.
- Los diagramas Mermaid aparecen dibujados, no como código; los bloques de código conservan el resaltado.
- Los saltos de página se eligen para que un título no quede solo al pie de una página y para que un diagrama no se parta en dos.
- El mismo archivo, venga de la app MarsDawn o de la línea de comandos gratuita; la guía paso a paso está en Markdown a PDF.
Siguiente
- Los temas y diseños de los que puede salir la exportación: temas de vista previa y exportación a PDF.
- Exportar desde un script o un agente en lugar de la app: marsdawn para agentes.
- Por qué una persona tiene que leer el documento primero: por qué revisar.
- Las entregas entre varios agentes son una fuente natural de PDF para compartir: Cuatro patrones de diseño de agentes y los documentos que te entrega cada uno.