Update mermaid to latest version

[Zerotask]

Select Topic Area

Product Feedback

Feature Area

Issues

Body

I noticed that GitHub is not using the latest version of mermaidjs since some things I were using are not displayed properly.
Therefore it would be nice to update it to the latest version.

Guidelines

• I have read the above statement and can confirm my post is relevant to the GitHub feature areas Issues and/or Projects.

[queenofcorgis]

Thanks for posting in the GitHub Community, @Zerotask !

We're happy you're here. You are more likely to get a useful response if you are posting your question in the applicable category, the Projects and Issues category is solely related to conversations around the GitHub products Issues and Projects. I've gone ahead and moved it for you. Good luck!

[Zerotask]

Hello @queenofcorgis

Thank you for your message. I posted it on the Issues category, since the problem occurs in an issue. Issues render mermaid syntax, but the latest charts/diagrams are missing.

[baynezy]

What is the GitHub roadmap for upgrading things like mermaid? Is that published anywhere? It makes it hard to commit to using features if they are going to languish and go stale.

[baynezy]

Currently the installed version mermaid is:

info

Loading

The above is dynamic, but the version is 10.0.2 at the time of writing, which was released on 2nd March 2023. The current version is 10.6.1 released on 6th November 2023

[praseodym]

v10.8.0 as of today 🥳

[thibaudcolas]

In addition to upgrading, it’d be nice to add which version is currently in use in the documentation for GitHub. See #37498 for a list of reasons why this would be helpful. It appears that #86514 for example is just a matter of the GitHub-bundled version being out-of-date.

[quilicicf]

Any news on this?
We keep getting bitten by the graphs-that-work-on-my-machine-but-not-on-GitHub issue :-(

[fdwr]

Hmm, I'm also seeing v 10.0.2, but my existing mermaid diagram just broke some time the past week or few since I last viewed the diagram on GitHub. Hypertext does not display correctly, and instead of Test["<b>Test</b>"] displaying as Test, I now literally see <b>Test</b> in the diagram. 😢

[baynezy]

This is my biggest problem with mermaid. It is a great idea, but spotty support makes it a lottery to work with. I have beautiful diagrams that I craft in my IDE or on mermaid.live and then they end up having to be converted to a PNG for GitHub and DevOps wiki as the support isn't there. Which completely negates the point.

[fdwr]

What tool do you use for conversion? Are SVG or HTML valid outputs?

[quilicicf]

Probably mermaid-cli ?
It does support SVG.

[fdwr]

Probably mermaid-cli

@quilicicf Arigatou - will try it.

[baynezy]

Sorry I use the Mermaid website. mermaid.live. It has an export function.

[ryanobjc]

I am using sequenceDiagrams in mermaid and looks like the version github has embedded doesn't support the 'create participant X' feature, which is a real bummer!

[moop-moop]

I totally agree with you. And I even wanted to use sequence diagrams to better document our GitHub Actions and Workflows.
That feature started in Mermaid 10.3

[abernier]

An amazing feature

mermaid-js/mermaid#2885 has been merged/is coming to mermaid, hope gh will bump the version so everyone can benefit from soon

[praseodym]

Looks like GitHub is on Mermaid v10.8.0 now!

[abernier]

does not seem to work in 10.8.0 (which GitHub is indeed running on): mermaid-js/mermaid#2885 (comment)

[praseodym]

That's because there hasn't been any Mermaid releases since the Katex feature has been merged. The Katex feature has been merged on 13 February 2024, and the current latest release of Mermaid was on 2 February 2024.

Once a new Mermaid release has been made, we'll have to wait for GitHub to update its Mermaid version. Hopefully that won't be too long!

[quilicicf]

Damn, you are right!

info

Loading

[mhartzell-incomm]

Mermaid 11.3 is out and DANG I need me some new nodes.

[notesbytom]

v11.4.1 (deployed on GitHub as of 2025-04-08) has a bug where Open Links/Edges A---B display with an Arrow Head like A-->B. I believe this is fixed in v11.5.0 mermaid-js/mermaid#6093 (comment) . Hopefully a fixed version will be deployed soon.

[diegosasw]

11.15.0
Current version is now 11.15.0, it contains event modeling diagrams.
Is there a way to upgrade mermaid for a GitHub repo instead of waiting for a global upgrade which seems to take too long?

[sunanana]

Mermaid v11.17.0 added subgraph support to ER diagrams (mermaid-js/mermaid#7792), which allows grouping entities into logical domains — something that has been requested for a long time (mermaid-js/mermaid#5168, mermaid-js/mermaid#7417).

However, the Mermaid version currently bundled on GitHub doesn't support it yet. As of today, GitHub is running Mermaid v11.16.1 (checked via the info diagram), so it's just one version behind. The subgraph / end keywords are parsed as plain entities, so the diagram below renders incorrectly:

erDiagram
    subgraph auth [Auth]
        users
        sessions
    end

    users ||--o{ sessions : "logs in"

Loading

It would be great if the bundled Mermaid version could be updated to v11.17.0 or later so that ER diagram subgraphs render properly in Markdown files, issues, and PRs.