La página de actualización de Visual Studio Code 1.146 de Microsoft registra un cambio en las herramientas de documentación para el período que finaliza el 13 de noviembre de 2026: el editor pasa de Mermaid 11 a Mermaid 12. El cambio es limitado, pero puede afectar a los equipos que consideran los diagramas Markdown representados como artefactos de ingeniería revisados.
Para los CTO y los responsables de ingeniería, la señal es clara: una actualización incluida de la biblioteca de diagramación debe formar parte del plan de pruebas de documentación. No se trata simplemente de un cambio de etiqueta de versión. Es un cambio de dependencia de representación con posibles consecuencias para la coherencia de las vistas previas, las aprobaciones y los flujos de trabajo de publicación.
1. Mermaid 12 sustituye a Mermaid 11
Qué es
La página de actualización de Visual Studio Code de Microsoft presenta la transición directamente:
| Antes | Después |
|---|---|
Mermaid 11 | Mermaid 12 |
El cambio forma parte de Visual Studio Code 1.146, cuya versión estable se publicó el 11 de noviembre de 2026, según el registro de versiones de Microsoft. Mermaid proporciona diagramas definidos mediante texto que habitualmente se integran en Markdown, mientras que Visual Studio Code integra la representación de Mermaid en sus herramientas relacionadas con Markdown.
Por tanto, la actualización cambia la versión principal utilizada por el flujo de trabajo integrado de diagramas del editor. Los desarrolladores que actualicen el editor recibirán la nueva versión principal sin instalar Mermaid por separado para esa experiencia integrada.
La información de versiones de Mermaid para 12.3.0 describe incorporaciones que incluyen formas de elementos BPMN, marcadores de borde de flecha abierta y círculo hueco, y animación opcional de bordes de diagramas de flujo. Estas capacidades upstream aportan contexto para la línea Mermaid 12, pero los equipos no deberían considerar confirmada en Visual Studio Code cada característica de 12.3.0 hasta que Microsoft identifique la versión menor incluida.
Por qué es importante
Un cambio importante de biblioteca de representación puede modificar el aspecto de los diagramas existentes incluso cuando el texto de origen no cambia. El diseño, el espaciado, los conectores, las etiquetas y el estilo son superficies de revisión para los diagramas de arquitectura y la documentación operativa.
Esto no es motivo para bloquear la actualización. Es motivo para probar los artefactos que importan.
Por qué es importante: Los equipos suelen utilizar la vista previa de Visual Studio Code al crear diagramas y, después, representar los mismos archivos mediante un generador de documentación independiente o una canalización de integración continua. Si esos entornos utilizan versiones principales diferentes de Mermaid, es posible que la vista previa del editor ya no coincida con el resultado publicado.
Para los sectores regulados, la coherencia de la documentación es un requisito de gobernanza. Un diagrama aprobado en un entorno de representación no debería producir silenciosamente una salida significativamente diferente en otro.
Los autores de extensiones también deben distinguir entre la compatibilidad integrada con Mermaid de Visual Studio Code y las dependencias de Mermaid empaquetadas por sus propias extensiones. Actualizar el editor no establece que todas las extensiones compatibles con Mermaid o los renderizadores externos se hayan trasladado a la misma versión.
Quizá el problema más importante sea la alineación de versiones. Si una vista previa del editor, una comprobación de solicitud de extracción y un sistema de publicación representan el mismo diagrama mediante versiones diferentes de Mermaid, los equipos pueden dedicar tiempo de revisión a investigar diferencias de salida en lugar de cambios de contenido.
El desarrollo centrado en agentes puede ser la trayectoria más amplia de las herramientas modernas para desarrolladores, pero las dependencias de documentación todavía requieren una disciplina convencional de versiones. La paridad de representación sigue siendo un control de ingeniería.
En resumen
Visual Studio Code 1.146 actualiza sus herramientas integradas de diagramas de Mermaid 11 a Mermaid 12. Microsoft confirma la transición de versión principal, pero la entrada de actualización no identifica la versión menor o de parche exacta de Mermaid 12.
Lo que esto significa para los equipos empresariales:
Cree una línea base. Capture la salida actual de diagramas Mermaid representativos y críticos para el negocio antes de implementar ampliamente Visual Studio Code
1.146.Compare la salida representada. Revise el diseño, las etiquetas, los conectores, los colores y la legibilidad después de la actualización, en lugar de depender únicamente de un análisis sintáctico correcto.
Compruebe la ruta de publicación. Determine si los generadores de documentación y los trabajos de integración continua utilizan Mermaid 11, Mermaid 12 u otro renderizador.
Separe la compatibilidad confirmada de la disponibilidad upstream. No prometa capacidades específicas de
12.3.0basándose únicamente en la confirmación de Microsoft deMermaid 12.Registre las diferencias aceptadas. Si el nuevo renderizador cambia diagramas aprobados, documente la decisión antes de que la salida actualizada llegue a la documentación de producción.
¡Feliz programación!