GitHub Supports Mermaid For Creating Diagrams
Written by Ian Elliot   
Tuesday, 15 February 2022

In a move that will help in combating doc-rot, GitHub has added support for Mermaid, the open source Markdown-like language that allows developers to generate diagrams and flowcharts.

flowchart

If you've not come across Mermaid before it is a Javascript-based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically in the browser. Its main purpose of Mermaid is to help documentation catch up with development.

According to its README:

Diagramming and documentation costs precious developer time and gets outdated quickly. But not having diagrams or docs ruins productivity and hurts organizational learning.

Mermaid addresses this problem by cutting the time, effort and tooling that is required to create modifiable diagrams and charts, for smarter and more reusable content. The text definitions for Mermaid diagrams allows for it to be updated easily, it can also be made part of production scripts (and other pieces of code). So less time needs to be spent on documenting, as a separate and laborious task.

Mermaid supports several common diagram types for software projects, including flowcharts, UML, Git graphs, user journey diagrams, and Gantt charts. It provides sample diagrams, and the code that creates them, in its Live Editor making it easy to use:

mermaidlive

 

The way it now works in GitHub is that code blocks marked as mermaid  cause an iframe to be generated that takes the raw Mermaid syntax and passes it to Mermaid.js, turning that code into a diagram in your local browser.

Now that GitHub makes Mermaid syntax available, information can be shared through rich, visual formats, resulting in better project management and quality and improved workflow.

 

More Information

Include diagrams in your Markdown files with Mermaid

Mermaid on GitHub

Related Articles

GitHub Improves Code Search

GitHub Launches Actions

To be informed about new articles on I Programmer, sign up for our weekly newsletter, subscribe to the RSS feed and follow us on Twitter, Facebook or Linkedin.

 

Banner


Petition Microsoft To Defer Windows 10 End of Support
03/10/2025

With 10 days to go until Microsoft ends free support for Windows 10, Windows 7 has seen an uptick in its market share, while Windows 11 has seen a slight downturn. A new petition is asking Microsoft t [ ... ]



Google Agent Dev Kit Adds LangChain4j Integration
13/10/2025

Google has updated its Agent Development Kit for Java to add integration with the LangChain4j LLM framework. This expands the range of large language models available to users of the development kit t [ ... ]


More News

pico book

 

Comments




or email your comment to: comments@i-programmer.info

 

<ASIN:1801078025>

<ASIN:B098KHTVJ2>

Last Updated ( Tuesday, 15 February 2022 )