top of page

Mermaid: diagramas como código

  • 4 feb
  • 15 Min. de lectura

📶 Diagramas como código: piensa, escribe y visualiza

En muchos proyectos técnicos —ingeniería, software, inteligencia artificial o automatización— llega siempre el mismo momento:

La idea está clara en tu cabeza, pero cuesta explicarla.

El problema no suele ser la complejidad. Es la falta de una representación clara. Ahí es donde entran los diagramas.

Tradicionalmente, crear diagramas implicaba herramientas gráficas, cajas arrastradas con el ratón, capturas de pantalla y documentos que envejecen mal. Muy mal.


Mermaid propone algo distinto. Una idea simple pero potente:

Si puedes escribirlo, puedes dibujarlo.

Mermaid te permite crear diagramas usando solo texto, directamente dentro de Markdown:

  • Sin editores visuales.

  • Sin imágenes externas.

  • Sin diagramas desactualizados.


Crea diagramas con Mermaid
Crea diagramas con Mermaid


Escribes el diagrama como si fuera código y se renderiza automáticamente.


Por eso hablamos de diagramas como código.

Usamos Mermaid no solo para documentar, sino para pensar, explicar y enseñar sistemas complejos de forma clara y reproducible. Y una vez empiezas, cuesta volver atrás.


🧠¿Qué es Mermaid?

Mermaid es un lenguaje de diagramas basado en texto.

En lugar de dibujar cajas, flechas y conexiones con el ratón, describes el diagrama escribiendo texto con una sintaxis sencilla. Mermaid se encarga de interpretarlo y renderizarlo automáticamente como un diagrama visual.

Dicho de otra forma:

Mermaid convierte texto en diagramas.

No es un editor gráfico. No es una herramienta de diseño. Es un lenguaje, como Markdown o HTML, pensado para describir estructuras.

Un ejemplo muy simple:

flowchart TD
    A --> B --> C

Ese texto se convierte directamente en un diagrama de flujo.


¿Cómo visualizar el diagrama?

La manera más rápida es entrar en la web "mermaid live" (https://mermaid.live/) y copiar ahí el código. Veremos en tiempo real como cada modificación que hagamos en el código va modificando el diagrama que se crea.


Mermaid Live
Mermaid Live

¿Qué tipo de diagramas permite crear?

Con Mermaid puedes crear, entre otros:

  • Diagramas de flujo (flowcharts)

  • Diagramas de secuencia

  • Diagramas de estados

  • Diagramas de Gantt

  • Diagramas entidad–relación (ER)

  • Mapas mentales

  • Diagramas de arquitectura

Todo ello usando solo texto plano.


Diagramas para crear con Mermaid
Diagramas para crear con Mermaid

Mermaid y Markdown

Uno de los grandes puntos fuertes de Mermaid es que vive muy bien dentro de Markdown.

Esto permite que tus diagramas:

  • Estén junto al texto que explican

  • Formen parte del mismo documento

  • Se versionen con Git

  • Se mantengan siempre actualizados

El diagrama deja de ser una imagen externa y pasa a ser parte del contenido.


Qué NO es Mermaid

Para evitar confusiones:

  • ❌ No es Figma

  • ❌ No es Draw.io

  • ❌ No es un editor visual WYSIWYG

Mermaid no está pensado para “diseñar bonito”, sino para explicar claro.


¿Para quién es Mermaid?

Mermaid es especialmente útil si:

  • Documentas procesos, sistemas o arquitecturas

  • Trabajas con Markdown

  • Usas Git o control de versiones

  • Quieres diagramas que evolucionen con el proyecto

  • Prefieres texto antes que herramientas gráficas


💙¿Por qué usar Mermaid?

Usar Mermaid no va solo de hacer diagramas. Va de cómo piensas, documentas y mantienes el conocimiento.

En muchos proyectos, los diagramas acaban siendo imágenes pegadas en un documento, difíciles de actualizar y desconectadas del texto que explican. Con el tiempo, dejan de representar la realidad.


Mermaid evita ese problema desde la base. Al estar basado en texto, un diagrama en Mermaid:

  • Se edita igual que cualquier otro contenido

  • Se versiona junto al código o la documentación

  • Evoluciona con el proyecto

  • No depende de herramientas externas

Pero hay más.

1️⃣ Diagramas mantenibles

Cambiar un diagrama en Mermaid es cambiar texto. No hay que rehacer imágenes ni buscar el archivo original.

Esto hace que los diagramas no se queden obsoletos.


2️⃣ Pensamiento estructurado

Mermaid te obliga a ordenar ideas antes de dibujarlas. No empiezas arrastrando cajas, empiezas pensando:

  • qué elementos existen

  • cómo se relacionan

  • qué flujo siguen

El diagrama es una consecuencia del razonamiento, no al revés.


3️⃣ Integración natural con documentación

Al vivir dentro de Markdown, los diagramas:

  • Aparecen justo donde hacen falta

  • Se leen junto al texto

  • Forman parte del discurso

La documentación deja de ser texto por un lado e imágenes por otro.


4️⃣ Ideal para equipos técnicos

Mermaid encaja especialmente bien en entornos técnicos:

  • Ingeniería

  • Software

  • IA

  • Automatización

  • Proyectos complejos

Cualquiera que se sienta cómodo editando texto puede modificar un diagrama.


5️⃣ Diagramas como código

Todo esto se resume en una idea clave:

Los diagramas son código.

Se escriben, se revisan, se versionan y se mejoran igual que cualquier otro activo del proyecto.

Y eso cambia completamente la forma de documentar.


🏎️Mermaid + IA (LLMs): diagramas a la velocidad del pensamiento

Hasta hace poco, usar Mermaid implicaba pensar el diagrama y escribirlo a mano. Eso ya era potente.

Pero hoy hay un salto cualitativo.

Con la llegada de los LLMs (Large Language Models), Mermaid se convierte en una herramienta aún más interesante:

puedes generar diagramas directamente a partir de información en bruto.

Texto largo, documentación técnica, PDFs, actas de reunión, código, requisitos o notas desordenadas. La IA se encarga de analizar y estructurar, y tú obtienes código Mermaid listo para usar.


¿Qué tipo de cosas se pueden pedir a un LLM?

Algunos ejemplos muy prácticos:

  • 📄 Convertir un PDF en un mapa mental

  • 📝 Pasar un acta de reunión a un diagrama de flujo

  • 🧠 Resumir un documento largo como arquitectura visual

  • 🔁 Transformar reglas o lógica en diagramas de estados

  • 🗂️ Generar diagramas ER a partir de una descripción de datos

Mermaid actúa como el formato de salida estructurado.


Ejemplos de prompts reales

🧠 De PDF a mapa mental

“Dado este PDF, crea un mapa mental en formato Mermaid que resuma los conceptos principales y sus relaciones.”

Resultado típico:

mindmap
  root((Documento))
    Concepto A
      Subidea A1
      Subidea A2
    Concepto B
      Subidea B1
de PDF a mapa mental
de PDF a mapa mental

Un ejemplo real lo podemos ver en la siguiente imagen, donde le hemos pasado como PDF un documento que ya generamos en un artículo anterior donde se explicaba como se reconstituye la nata congelada:


Mapa mental - Proceso reconstitución nata congelada
Mapa mental - Proceso reconstitución nata congelada


🔄 De texto a flujo de proceso

Prompt:

“A partir de este texto, genera un diagrama de flujo en Mermaid que represente el proceso descrito.”

Resultado tipico

flowchart TD
    A[Inicio] --> B[Entrada de datos]
    B --> C{Validación}
    C -->|OK| D[Proceso]
    C -->|Error| E[Corrección]

Usamos el mismo PDF que antes para ver como quedaría:

Diagrama de flujo con Mermaid
Diagrama de flujo con Mermaid

⏱️ De planning a Gantt

Prompt

“Convierte este planning de proyecto en un diagrama de Gantt usando Mermaid.”

Resultado tipico

gantt
    title Project Overview
    dateFormat YYYY-MM-DD

    section Phase 1
    Analysis :a1, 2026-01-01, 15d
    Design   :a2, after a1, 20d

Vamos a usar este prompt de ejemplo "real":

Crea un planning para una secuencia de mudanza de una casa en formato de diagrama de Gantt usando Mermaid
Diagrama Gantt en Mermaid
Diagrama Gantt en Mermaid

Buenas prácticas al usar IA con Mermaid

  • ✔️ Pide un solo diagrama por prompt

  • ✔️ Especifica el tipo de diagrama (flowchart, mindmap, gantt…)

  • ✔️ Indica el nivel de detalle esperado

  • ✔️ Revisa siempre el resultado (la IA ayuda, no sustituye el criterio)


Mermaid + IA = documentación viva

Esta combinación permite algo clave:

  • Diagramas rápidos

  • Diagramas actualizables

  • Diagramas alineados con el texto

En lugar de documentos estáticos, tienes documentación viva, que evoluciona con el proyecto.

Lo usamos así: pensamos → pedimos → ajustamos → publicamos.


📊¿Cómo usar Mermaid?

Mermaid no requiere instalaciones complejas ni herramientas especiales para empezar. De hecho, puedes ver resultados en cuestión de segundos.

La idea básica siempre es la misma:

  1. Escribes código Mermaid

  2. Un visor lo renderiza

  3. Ves el diagrama


Opción 1️⃣ Visor online (la forma más rápida)

La manera más sencilla de empezar es usar un visor online.

La referencia más conocida es Mermaid Live  (https://mermaid.live/).

El flujo es muy simple:

  • Entras en la web

  • Pegas tu código Mermaid

  • Ves el diagrama renderizado en tiempo real


Cada cambio que haces en el texto se refleja inmediatamente en el diagrama, lo que lo convierte en una herramienta ideal para aprender y experimentar.

Es perfecto para:

  • Probar ideas rápidas

  • Aprender la sintaxis

  • Ajustar diagramas antes de llevarlos a un proyecto real


Mermaid Live  (https://mermaid.live/)
Mermaid Live  (https://mermaid.live/)

Opción 2️⃣ Markdown con soporte Mermaid

Si trabajas con Markdown, muchos entornos soportan Mermaid de forma nativa o mediante plugins.

El patrón habitual es este:

```mermaid
flowchart TD
    A --> B --> C
```

El bloque se renderiza automáticamente como un diagrama.

Este enfoque es ideal para:

  • documentación técnica

  • README de proyectos

  • wikis

  • artículos de blog

El diagrama vive junto al texto que lo explica.


Opción 3️⃣ Integración en HTML o webs

En páginas web o blogs, Mermaid puede integrarse usando un bloque HTML específico.

Un ejemplo típico:

<div class="mermaid">
flowchart TD
    A --> B --> C
</div>

Esto permite incrustar diagramas directamente en el contenido de una página, sin imágenes externas.

¿Qué opción elegir?

Depende del contexto:

  • Aprender o probar → visor online

  • Documentar proyectos → Markdown

  • Publicar contenido → Markdown o HTML

Lo importante es que el código Mermaid es siempre el mismo. Solo cambia dónde lo pegas.


📓Ejemplos prácticos de Mermaid

La mejor forma de aprender Mermaid no es memorizando sintaxis, sino viendo ejemplos reales y reutilizables.

A partir de aquí encontrarás una colección de diagramas pensados para copiar y pegar, modificar y adaptar a tus propios proyectos

No son ejemplos “de manual”, sino casos habituales en documentación técnica, ingeniería, IA, automatización y divulgación.

Cada ejemplo sigue la misma lógica:

  • un objetivo claro

  • un tipo de diagrama concreto

  • código Mermaid listo para usar

No necesitas conocer toda la sintaxis. Empieza por un ejemplo cercano a tu caso, cámbialo poco a poco y deja que el diagrama evolucione contigo.


  1. Diagramas de flujo (Flowchart)

Los diagramas de flujo son probablemente el uso más habitual de Mermaid. Sirven para representar:

  • procesos paso a paso

  • workflows

  • pipelines

  • decisiones lógicas

Son especialmente útiles cuando quieres explicar qué pasa primero, qué pasa después y bajo qué condiciones.

Ejemplo 1️⃣ Flujo simple

Un flujo lineal básico, ideal para empezar:

flowchart TD
    A[Inicio] --> B[Proceso]
    B --> C[Resultado]

Ejemplo 2️⃣ Flujo con etapas técnicas

Un ejemplo algo más realista, típico de workflows técnicos o de IA:

flowchart TD
    A[Input] --> B[Preprocess]
    B --> C[Processing]
    C --> D[Postprocess]
    D --> E[Output]

Aquí ya se empieza a ver cómo Mermaid permite estructurar procesos complejos de forma clara.


Ejemplo 3️⃣ Flujo con decisiones y ramificaciones técnicas

flowchart LR
    A[Start] --> B{Tipo de modelo}
    B -->|SDXL| C[Cargar SDXL]
    B -->|SD 1.5| D[Cargar SD 1.5]
    C --> E[Inferencia]
    D --> E
    E --> F[Salida]
imagen de Diagrama de flujo con decisiones y ramificaciones técnicas
Diagrama de flujo con decisiones y ramificaciones técnicas

Este tipo de diagrama es ideal para:

  • validaciones

  • lógica de negocio

  • control de errores

  • automatización

  • explicar elecciones técnicas

  • documentar configuraciones

  • guiar decisiones


Ejemplo 4️⃣ Generar un diagrama de flujo usando IA

Además de escribir los diagramas a mano, Mermaid encaja perfectamente con el uso de IA generativa.

Puedes pedir a un LLM que analice un texto o una descripción y te devuelva directamente el código Mermaid del flujo correspondiente.

Un ejemplo de prompt real:

Prompt para IA

“A partir de la siguiente descripción, genera un diagrama de flujo en formato Mermaid que represente el proceso descrito. Usa nodos claros y un flujo de arriba hacia abajo. 
Descripción: El usuario sube una imagen, el sistema la valida. Si es válida, se procesa y se genera un resultado. Si no es válida, se solicita una corrección y se vuelve a intentar.”

Resultado típico generado por la IA:


Ejemplo de flowchart
Ejemplo de flowchart

Este enfoque es especialmente útil cuando:

  • partes de texto no estructurado

  • tienes procesos descritos en lenguaje natural

  • quieres documentar rápido sin dibujar a mano

La IA te ayuda a convertir palabras en estructura, y Mermaid actúa como el formato visual final.


  1. Diagramas de arquitectura

Los diagramas de arquitectura sirven para mostrar cómo se conectan los distintos componentes de un sistema.

Son especialmente útiles para explicar sistemas de software, arquitecturas de IA, pipelines técnicos, infraestructuras sencillas...


Ejemplo 1️⃣ Arquitectura básica

Un esquema simple para entender la estructura general:

graph TD
    User --> UI[Web UI]
    UI --> Backend
    Backend --> Database

Este tipo de diagrama es ideal para:

  • vistas generales

  • documentación inicial

  • presentaciones técnicas


Ejemplo 2️⃣ Arquitectura de IA local

Un ejemplo típico en entornos de IA local:

graph TD
    User --> UI[Web Interface]
    UI --> LLM[Local LLM]
    LLM --> Engine[Processing Engine]
    Engine --> GPU
    GPU --> Storage[Outputs]

Aquí se ve claramente:

  • el punto de entrada del usuario

  • el motor de procesamiento

  • el uso de recursos


Ejemplo 3️⃣ Arquitectura como sistema de bloques

Mermaid también es útil para esquemas conceptuales:

graph LR
    Input --> Processing --> Output
    Processing --> Monitoring
    Processing --> Logging

Muy útil para:

  • documentación conceptual

  • explicaciones rápidas

  • sistemas abstractos


Ejemplo 4️⃣ Generar un diagrama de arquitectura usando IA

Prompt:

“A partir de la siguiente descripción, genera un diagrama de arquitectura en formato Mermaid usando graph TD. Usa nombres claros para los nodos y representa el flujo de información.
Descripción:
Un usuario accede a una interfaz web. La interfaz envía peticiones a un backend. El backend valida al usuario, procesa la lógica principal y accede a una base de datos. El resultado se devuelve al usuario.”
Ejemplo de diagrama de arquitectura
Ejemplo de diagrama de arquitectura

Este enfoque es especialmente útil cuando:

  • tienes descripciones funcionales en documentos

  • estás en fases tempranas de diseño

  • necesitas visualizar rápido una arquitectura

  • quieres validar si la estructura “tiene sentido”


  1. Diagramas de secuencia

Los diagramas de secuencia se utilizan para mostrar cómo interactúan varios actores a lo largo del tiempo. Muestran quién habla con quién y en qué orden.


Ejemplo 1️⃣ Secuencia básica

Un ejemplo sencillo para entender el formato:

sequenceDiagram
    User->>System: Request
    System-->>User: Response

Ejemplo 2️⃣ Secuencia como explicación funcional

sequenceDiagram
    Client->>API: Request
    API->>Auth: Check permissions
    Auth-->>API: Allowed
    API->>Service: Execute
    Service-->>API: Result
    API-->>Client: Response

Ideal para documentación técnica o funcional.


Ejemplo secuencia
Ejemplo diagrama de secuencia

Ejemplo 3️⃣ Generar un diagrama de secuencia con IA

Prompt

“A partir de la siguiente descripción, genera un diagrama de secuencia en formato Mermaid.
Requisitos:
Usa sequenceDiagram
Nombra claramente los actores
Representa el flujo de interacciones en orden temporal
Incluye validaciones o respuestas si aparecen en el texto
Descripción: Un usuario inicia sesión desde una interfaz web. La interfaz envía las credenciales al backend. El backend valida al usuario con el servicio de autenticación. Si es válido, se devuelve acceso al usuario. Si no, se devuelve un error.”
Código diagrama de secuencia generado con IA
Código diagrama de secuencia generado con IA

Este tipo de prompt funciona muy bien cuando:

  • tienes flujos descritos en texto

  • quieres documentar rápidamente

  • necesitas visualizar interacciones sin diseñar a mano


  1. Diagramas de Gantt

Los diagramas de Gantt se utilizan para representar planificación temporal.

Son especialmente útiles en gestión de proyectos, planificación técnica, ingeniería, fases de ejecución


Ejemplo 1️⃣ Gantt simple

Un ejemplo básico para entender la estructura:

gantt
    title Project Timeline
    dateFormat YYYY-MM-DD

    section Planning
    Analysis        :a1, 2026-01-01, 10d
    Design          :a2, after a1, 15d

Ejemplo 2️⃣ Gantt como herramienta de comunicación

gantt
    title High-Level Planning
    dateFormat YYYY-MM-DD

    section Phase 1
    Study     :p1, 2026-01-01, 15d

    section Phase 2
    Build     :p2, 2026-02-01, 30d

    section Phase 3
    Deploy    :p3, 2026-03-15, 10d
Diagrama tipo Gantt
Diagrama tipo Gantt

Este tipo de Gantt es perfecto para:

  • presentaciones

  • comunicación con stakeholders

  • visión macro del proyecto


Ejemplo 3 Gantt generado con IA a partir de un documento de oferta

Prompt (adjuntado PDF con una oferta de un proyecto)

Analiza en detalle este PDF que es el documento de oferta de un proyecto de ingeniería donde se explica y detalla el alcance, así como los plazos de cada fase. Supondremos que el proyecto empieza el día 1 de mayo, y en base a esto, hazme un diagrama de gantt en formato mermaid
Diagrama Gantt generado desde documento de oferta
Diagrama Gantt generado desde documento de oferta
  1. Diagramas de estados

Los diagramas de estados se utilizan para representar cómo cambia un sistema a lo largo del tiempo en función de eventos o condiciones. Ideales para automatización, lógica de control, máquinas de estado o software.


Ejemplo 1️⃣ Diagrama de estados básico

Un ejemplo sencillo para entender el concepto:

stateDiagram-v2
    Idle --> Running
    Running --> Stopped

Ejemplo 2️⃣ Estados como lógica de control

stateDiagram-v2
    [*] --> Init
    Init --> Ready
    Ready --> Processing
    Processing --> Completed
    Processing --> Error
    Error --> Ready

Este tipo de diagrama es muy común en:

  • PLCs

  • software embebido

  • flujos de ejecución controlados


Ejemplo 3️⃣ usando IA (chatGPT)

Le vamos a pasar un código de un software para que nos genere el diagrama de estados de ese código.

Prompt (adjuntando al prompt el archivo .html de código)

Revisa este código HTML-CSS-JS que es una simulación del juego de la vida de Conway. Analízalo y genera un diagrama de estados de Mermaid que represente la lógica de control de este simulador
Diagrama de estados a partir de un código de software
Diagrama de estados a partir de un código de software
  1. Diagramas entidad-relación (ER)

Los diagramas entidad–relación se utilizan para representar estructuras de datos y sus relaciones.

No describen flujos ni estados, sino qué entidades existen, qué atributos o roles tienen y cómo se relacionan entre sí

Son especialmente útiles en diseño de bases de datos, modelado de información, APIs y sistemas de datos y documentación técnica


Ejemplo 1️⃣ ER básico

Un ejemplo muy simple para entender la sintaxis:

erDiagram
    USER ||--o{ ORDER : places

Ejemplo 2️⃣ ER como modelo conceptual

erDiagram
    CUSTOMER ||--o{ INVOICE : generates
    INVOICE ||--o{ LINE : contains
    PRODUCT ||--o{ LINE : referenced_in
    Diagrama de Entidad-Relación
Diagrama de Entidad-Relación

Este tipo de diagrama es muy útil para:

  • documentación funcional

  • análisis de datos

  • diseño previo a implementación


Ejemplo 3️⃣ usando IA (chatGPT)

Le vamos a pasar un código de un software para que nos genere el diagrama entidad-relación de ese código.

Prompt (adjuntando al prompt el archivo .html de código)

Revisa este código HTML-CSS-JS que es una simulación del juego de la vida de Conway. Analízalo y genera un diagrama entidad-relación (ER) Mermaid que me sirva para la documentación de este software
Diagrama Entidad-Relación de un código de software
Diagrama Entidad-Relación de un código de software

Un diagrama ER responde a la pregunta:¿qué datos existen y cómo se relacionan?. Si estás modelando información, este es el diagrama adecuado.


  1. Mindmaps

Los mapas mentales se utilizan para organizar ideas alrededor de un concepto central.

No buscan precisión técnica ni flujos exactos, sino estructurar información, resumir contenidos, explorar relaciones y facilitar la comprensión global

Son especialmente útiles en resúmenes de documentos, lluvia de ideas, planificación de artículos, formación y estudio y divulgación técnica. Muy útil para cerrar documentos largos o como material didáctico.


Ejemplo 1️⃣ Mapa mental básico

Un ejemplo mínimo para entender la estructura:

mindmap
  root((Idea Central))
    Concepto A
    Concepto B

Este formato es ideal para esquemas rápidos.


Ejemplo 2️⃣ usando IA (chatGPT)

Le vamos a pasar un libro en PDF para que nos haga un mapa mental de dicho libro. Esto es aplicable a cualquier tipo de documento.

Te estoy pasando un libro en formato PDF. Analízalo en detalle, y genérame un mapa mental de dicho libro en formato mermaid.
Mapa mental de un documento
Mapa mental de un documento
  1. Árboles de decisión

Los árboles de decisión se utilizan para representar elecciones y caminos posibles a partir de una serie de preguntas o condiciones. Son una variante de los diagramas de flujo, pero con un foco muy claro:

  • tomar decisiones

  • comparar opciones

  • guiar elecciones técnicas o funcionales


Ejemplo 1️⃣ Árbol de decisión básico

Un ejemplo sencillo para entender la estructura:

flowchart TD
    A[Inicio] --> B{¿Condición?}
    B -->|Sí| C[Opción A]
    B -->|No| D[Opción B]

Este patrón es ideal para decisiones binarias simples.

Ejemplo 2️⃣ Árbol de decisión como guía práctica

flowchart TD
    A[Inicio] --> B{¿Uso puntual?}
    B -->|Sí| C[Solución simple]
    B -->|No| D{¿Uso recurrente?}
    D -->|Sí| E[Automatizar]
    D -->|No| F[Manual]
Árboles de decisión
Árboles de decisión

Ideal para guías paso a paso y onboarding.

Idea clave: un árbol de decisión responde a la pregunta :¿qué opción debo elegir y por qué?. Si necesitas guiar elecciones de forma clara, este es el diagrama adecuado.


  1. Diagrama tipo "Quadrant"

Diagrama tipo Quadrant
Diagrama tipo Quadrant

  1. Diagrama tipo Kanban

Diagrama tipo Kanban
Diagrama tipo Kanban

  1. Diagrama tipo Packet

Diagrama tipo Packet
Diagrama tipo Packet

  1. Diagramas tipo Sankey

Diagrama tipo Sankey
Diagrama tipo Sankey
  1. Diagrama tipo "timeline"

Diagrama tipo "Timeline"
Diagrama tipo "Timeline"

  1. Diagrama tipo "Treemap"

Diagrama tipo "Treemap"
Diagrama tipo "Treemap"

  1. Diagrama tipo "User Journey"

Diagrama tipo "User Journey"
Diagrama tipo "User Journey"

🗒️Buenas prácticas al usar Mermaid

  • ✔️ Usa nombres claros y descriptivos en los nodos

  • ✔️ No satures un diagrama: divide en varios.

  • ✔️ Un diagrama = una idea

  • ✔️ Piensa primero, dibuja después

  • ✔️ No intentes “diseñar”, intenta explicar

  • ✔️ Revisa siempre los diagramas generados por IA


Un buen diagrama no impresiona. Se entiende.

Si alguien entiende el sistema solo mirando el diagrama, has hecho un buen trabajo.



💙Capítulo extra – Markmap: otro lenguaje de texto a diagrama

Mermaid no es la única herramienta que permite convertir texto en diagramas. Hay otras propuestas muy interesantes que siguen la misma filosofía: escribir primero, visualizar después.

Una de las más útiles para mapas mentales es Markmap.


¿Qué es Markmap?

Markmap se usa para convertir texto en formato Markdown en mapas mentales interactivos.

A diferencia de Mermaid:

  • no define flujos ni arquitecturas

  • no usa sintaxis específica de diagramas

Su enfoque es mucho más simple: La estructura del Markdown se convierte directamente en un mapa mental.


¿Cuándo tiene sentido usar Markmap?

Markmap es especialmente útil cuando quieres:

  • resumir documentos largos

  • estructurar libros o artículos

  • estudiar o preparar formación

  • explorar ideas de forma rápida

  • visualizar jerarquías de contenido

Es ideal para pensamiento y síntesis, más que para procesos técnicos.


Markmap + IA: un encaje natural

Markmap encaja perfectamente con IA, permitiendo crear un un flujo muy potente:

Texto largo → IA → Markdown estructurado → Mapa mental


Ejemplo práctico: mapa mental de un libro usando IA

Prompt para ChatGPT (ejemplo real)

Resume el siguiente libro en un mapa mental usando Markmap, con una estructura jerárquica clara. Requisitos: Usa títulos y subtítulos (#, ##, ###) No escribas texto explicativo, solo estructura Organiza las ideas de forma lógica y progresiva. Libro que adjunto: "La_divina_comedia-Dante_Alighieri.pdf"

Ejemplo de salida generada por la IA (Markdown)

# Libro

## Parte I – Introducción
- Contexto
- Objetivos
- Conceptos clave

## Parte II – Desarrollo
- Capítulo 1
  - Idea principal

Ese texto ya es el diagrama.


¿Cómo visualizarlo?

La forma más rápida de verlo es usar el visor online oficial de Markmap: 👉 https://markmap.js.org/repl

El proceso es muy simple:

  1. Entras en el visor

  2. Pegas el Markdown generado por la IA

  3. Ves el mapa mental renderizado al instante

Cada cambio en el texto modifica automáticamente el mapa.


Diagrama en Markmap
Diagrama en Markmap

Mermaid vs Markmap

No son herramientas excluyentes, sino complementarias:

  • Mermaid → procesos, flujos, arquitectura, estados, planificación

  • Markmap → ideas, resúmenes, libros, pensamiento jerárquico

Ambas comparten la misma idea de fondo: El texto es la fuente de verdad.


La combinación de:

  • IA para estructurar información

  • lenguajes como Mermaid o Markmap para visualizarla

permite pasar de texto desordenado a conocimiento visual en minutos. No dibujas. No maquetas. Escribes y ves.


📶 Mermaid como herramienta de pensamiento

Mermaid no es solo una forma cómoda de documentar. Es, sobre todo, una herramienta para pensar mejor.

Cuando escribes un diagrama en Mermaid no estás dibujando, estás identificando elementos, definiendo relaciones, aclarando flujos y detectando incoherencias


Es una herramienta para:

  • Pensar mejor

  • Explicar mejor

  • Enseñar mejor

  • Mantener sistemas vivos y actualizados


Idea clave

Si puedes explicarlo con claridad, puedes escribirlo. Y si puedes escribirlo, puedes dibujarlo.

Mermaid cierra el círculo entre pensar, escribir y visualizar.


👉 Guarda este artículo como referencia.

👉 Copia los ejemplos y adáptalos a tus proyectos.

👉 Úsalos en documentación, formación o trabajo diario.


Y si quieres ver Mermaid aplicado a IA real, workflows y automatización…

💙 Sigue explorando el blog de Lozkorp.


🌐 Recursos útiles

Comentarios


© 2025 by Lozkorp                                                         

bottom of page