Blog

Exporta tu proyecto completo como contexto para ChatGPT o Claude

La versión 0.8.0 exporta proyectos completos en un Markdown pensado para una IA o en ZIP, importa desde Excalidraw y le da al pizarrón un estilo hecho a mano.

Tus diagramas cuentan cómo funciona tu sistema: los flujos de autenticación, el esquema de la base de datos, la secuencia entre servicios. Es justo el contexto que le falta a un asistente de IA cuando le preguntas por tu arquitectura. Hasta ahora había que copiarlos uno por uno. Desde la versión 0.8.0 exportas el proyecto entero en un paso.

Dos formatos, dos usos

Al exportar un proyecto (o solo una carpeta) eliges entre:

  • ZIP: una subcarpeta por cada carpeta del proyecto, un archivo por diagrama con la extensión de su lenguaje (.mmd, .puml, .d2, .dbml o .freehand.json para el pizarrón), su descripción en un .md al lado, un README.md con el índice y un manifest.json para volver a importarlo.
  • Markdown en un solo archivo, en dos variantes:
    • Para contexto de IA: empieza con un preámbulo que le explica al modelo qué es el archivo, incluye un índice con las rutas, los metadatos de cada diagrama y una estimación de tokens. Está listo para pegarlo en ChatGPT o Claude.
    • Estándar: un documento limpio para tu wiki o tu repositorio.

En ambos casos los diagramas van en bloques de código con su etiqueta (mermaid, plantuml, d2, dbml), así que cualquier herramienta que entienda Markdown los reconoce.

Cómo se ve el flujo

flowchart LR
    A[Proyecto en DiagramaHub] --> B{¿Para qué lo necesitas?}
    B -->|Darle contexto a una IA| C[Markdown para IA]
    B -->|Documentación| D[Markdown estándar]
    B -->|Respaldo o migración| E[ZIP]
    C --> F[ChatGPT / Claude]
    D --> G[Wiki o README]
    E --> H[Importar en otra instancia]

Antes de descargar, DiagramaHub te muestra qué se va a exportar: número de diagramas y carpetas, tamaño y, en la variante para IA, los tokens aproximados. Así sabes si cabe en la ventana de contexto de tu modelo antes de pegarlo.

Dónde está

  • En el explorador del editor, con el icono de descarga (proyecto completo) o desde el menú de una carpeta → Exportar carpeta.
  • En la lista de proyectos.

Y de regreso: importar

La otra mitad de la historia es traer diagramas. Desde el icono de subida del explorador, el menú de una carpeta (Importar aquí) o arrastrando archivos desde tu sistema sobre el explorador, puedes importar:

  • Archivos sueltos .mmd, .puml, .d2, .dbml, Markdown con un bloque de código y pizarrones .freehand.json.
  • ZIP: los exportados por DiagramaHub restauran carpetas y colores; cualquier otro ZIP crea carpetas a partir de sus rutas.
  • Dibujos de Excalidraw (.excalidraw): formas, etiquetas, flechas conectadas, trazos y texto se convierten en un pizarrón.

Antes de crear nada ves una vista previa con las carpetas y diagramas que se van a crear, los archivos que se omiten y por qué, y el cupo de tu plan. La importación es de todo o nada: si algo falla a medio camino, se revierte lo creado.

El pizarrón ahora se ve hecho a mano

La 0.8.0 también trae la mayor actualización del pizarrón desde que llegó:

  • Aspecto hecho a mano en formas, líneas y flechas, con estilos de trazo (Limpio, Arquitecto, Artista, Caricatura) y de relleno (sólido, rayado, cruzado).
  • Trazo libre suave con grosor variable y presión del lápiz.
  • Fuente manuscrita para los textos nuevos, con selector Manuscrita / Normal / Código.
  • Bloquear elementos (Ctrl/Cmd+Shift+L) para que no se muevan, redimensionen ni borren por accidente.
  • Exportar a PNG en 1x, 2x o 3x, con fondo transparente opcional, y descargar la fuente como .freehand.json.
  • Boceto → Mermaid: las formas con texto se vuelven nodos y las flechas conectadas, relaciones de un diagrama de flujo nuevo. No usa IA, así que el resultado es exacto y repetible.

Los dibujos que ya tenías conservan su estilo limpio; solo los elementos nuevos usan el estilo a mano, y puedes cambiarlo por elemento.

Sin lock-in

Tus diagramas son texto, y ahora salen y entran de DiagramaHub sin fricción. Puedes llevarte un proyecto a tu repositorio, compartirlo con alguien que use otra instancia o darle a tu IA el mapa completo de tu sistema.

Ya está disponible en DiagramaHub Cloud y en la versión self-host. Los detalles técnicos están en el changelog.