Sharp Diagrams: diagramas Mermaid para Confluence y Jira
Escribe diagramas como texto y obtén dibujos nítidos y ampliables en páginas de Confluence e incidencias de Jira. Dos aplicaciones, una para cada producto, próximamente en Atlassian Marketplace.

¿Qué es Sharp Diagrams?
Sharp Diagrams dibuja diagramas Mermaid a partir de texto: en Confluence como una macro en la página y en Jira en un panel de la incidencia. Mermaid es un formato de texto para diagramas de flujo, diagramas de secuencia, diagramas de Gantt y otros diagramas.
Hay dos aplicaciones con el mismo motor de diagramas. Sharp Diagrams – Mermaid for Confluence añade una macro de diagramas con editor y vista previa en directo. Sharp Diagrams – Mermaid for Jira dibuja en un panel los bloques de código mermaid de la descripción de la incidencia. Instala la del producto que usas, o las dos.
Ningún dato sale de Atlassian. Las aplicaciones funcionan en la plataforma Forge de Atlassian, no tienen conexiones externas y no guardan nada propio: el código del diagrama se queda en tu página de Confluence o en tu incidencia de Jira.
¿Cómo añado un diagrama Mermaid en Confluence y Jira?
La documentación de Mermaid describe todos los tipos de diagrama y su sintaxis: mermaid.js.org (en inglés).
Confluence
- Edita una página, escribe /mermaid y elige Mermaid diagram.
- Escribe el código Mermaid a la izquierda o elige una plantilla en Start from.
- La vista previa de la derecha se actualiza mientras escribes. Si el código tiene un error, el mensaje y el número de línea aparecen debajo del código.
- Selecciona Save y publica la página. Para cambiar el diagrama más adelante, edita la página, selecciona el diagrama y pulsa el botón de edición (lápiz).
Jira
- En la descripción de la incidencia, añade un bloque de código, elige mermaid como lenguaje y escribe el código del diagrama en el bloque.
- Abre la incidencia y elige Mermaid diagrams en el botón de aplicaciones que hay bajo el título. A partir de entonces, el panel se queda en la incidencia.
- Cada bloque de código mermaid de la descripción se convierte en un diagrama propio en el panel. Cuando cambies la descripción, vuelve a cargar la incidencia para ver el nuevo diagrama.
Funciones
Vista previa mientras escribes
Escribe el código Mermaid a la izquierda y ve el diagrama a la derecha. Si hay un error, aparecen el mensaje y el número de línea, y el último diagrama correcto sigue a la vista.
Plantillas para 11 tipos de diagrama
Diagrama de flujo, de secuencia, de clases, de estados, entidad-relación y de Gantt, mapa mental, línea de tiempo, gráfico circular, recorrido de usuario y gráfico de Git. El editor pregunta antes de que una plantilla sustituya tu propio código.
Diagramas nítidos a la medida
Los diagramas se dibujan en SVG al ancho de la página o del panel y se mantienen nítidos al ampliarlos. Un diagrama muy ancho solo se reduce hasta el 75 % para que el texto siga siendo legible.
Zoom, descarga y copia
Amplía del 50 % al 300 % y vuelve a ajustar el diagrama al ancho. Descárgalo en SVG o en PNG al doble de tamaño para presentaciones y documentos, o copia su código.
Diagramas desde la descripción en Jira
Cada bloque de código mermaid de la descripción se convierte en un diagrama propio, así que una incidencia puede tener, por ejemplo, un diagrama de flujo y uno de secuencia. Los demás bloques de código no se tocan.
Modo claro y oscuro
Los diagramas siguen el modo de color de Confluence y Jira. En modo oscuro se dibujan con el tema oscuro de Mermaid.
Exportación a PDF y Word
Confluence genera las exportaciones en sus servidores, donde el diagrama no se puede dibujar, así que la exportación contiene el código del diagrama. Para poner el dibujo en un documento, descárgalo en PNG o SVG.
Los datos se quedan en Atlassian
Sin conexiones externas ni almacenamiento propio. En Jira, el panel lee la descripción con los permisos de quien ve la incidencia, así que solo muestra lo que esa persona ya puede ver.
Precios
Hasta 10 usuarios
Gratis.
100 usuarios
250 USD al año.
El precio se aplica a cada aplicación por separado. Atlassian se encarga de la facturación. Los precios de otros niveles de usuarios aparecerán en Atlassian Marketplace cuando se publiquen las aplicaciones. Los clientes del nivel gratuito reciben el mismo soporte que los clientes de pago.
Capturas de pantalla






Preguntas frecuentes
¿Cuánto cuesta Sharp Diagrams?
Es gratis para hasta 10 usuarios. Para 100 usuarios, el precio es de 250 USD al año. El precio se aplica a cada aplicación por separado, y Atlassian se encarga de la facturación.
¿Necesito las dos aplicaciones?
No. La aplicación de Confluence dibuja diagramas en páginas de Confluence, y la de Jira los dibuja a partir de la descripción de las incidencias. Instala la del producto que usas, o las dos.
¿Qué tipos de diagrama admite Sharp Diagrams?
Los tipos de diagrama de Mermaid, por ejemplo diagramas de flujo, de secuencia, de clases, de estados, entidad-relación y de Gantt, mapas mentales, líneas de tiempo, gráficos circulares, recorridos de usuario y gráficos de Git. El editor de Confluence tiene plantillas para estos 11 tipos.
¿Cómo añado un diagrama a una incidencia de Jira?
Añade a la descripción un bloque de código con el lenguaje mermaid y abre el panel Mermaid diagrams de la incidencia. Cada bloque de código mermaid se convierte en un diagrama propio. Cuando cambies la descripción, vuelve a cargar la incidencia para ver el nuevo diagrama.
¿Aparecen los diagramas en las exportaciones a PDF y Word?
La exportación contiene el código del diagrama como bloque de código, con una nota que indica que el dibujo está en la página. Confluence genera las exportaciones en sus servidores, donde el diagrama no se puede dibujar. Para poner el dibujo en un documento, descárgalo en PNG o SVG.
¿Sale algún dato de Atlassian?
No. Las aplicaciones funcionan en la plataforma Forge de Atlassian y no tienen conexiones externas. No guardan nada propio: el código del diagrama se queda en tu página de Confluence o en tu incidencia de Jira.
¿Se ejecutan los enlaces y el HTML de los diagramas?
No. Los diagramas se dibujan en el navegador de quien los ve con el nivel de seguridad estricto de Mermaid (strict), así que no se ejecutan enlaces, controladores de clic ni HTML dentro de los diagramas.
¿Qué pasa si la licencia no está activa?
El diagrama no se dibuja. En su lugar se muestra su código, así que no se pierde contenido.
Soporte y condiciones
Soporte: support@hdsoft.fi, de lunes a viernes de 9:00 a 17:00, hora de Finlandia, en inglés y finés. Los tiempos de respuesta y los avisos de seguridad están en la página de soporte (en inglés).
Documentación: cómo configurar y usar Sharp Diagrams (en inglés).
Privacidad: política de privacidad (en inglés).
Condiciones y otras aplicaciones: Aplicaciones para Jira y Confluence.
Próximamente en Atlassian Marketplace
Sharp Diagrams llegará a Confluence Cloud y Jira Cloud a través de Atlassian Marketplace. La documentación ya muestra cómo funciona.
Atlassian, Jira y Confluence son marcas comerciales de Atlassian. HD SofT crea las aplicaciones y les da soporte.
