10

Which version of mermaid is currently supported in AzureDevOps. In the official docs it only mentions some diagrams that are supported.

I was really loosing a lot of time because I was using features that are not supported by Azure DevOps.

I now went down to feature from 8.2.6 but I would like to know for sure which version is supported.

Thank you

Dariusz Woźniak
  • 9,640
  • 6
  • 60
  • 73
Marko
  • 929
  • 9
  • 27

6 Answers6

4

Based on your description, I further checked this problem. Currently, the wiki supports the following Mermaid diagram types:

  1. Sequence diagrams
  2. Gantt Charts

Wiki does not support other types of Mermaid diagrams, so this seems to have nothing to do with the version. Regarding this feature, I help you find a user voice. You can vote and add comments on it.

Alina Wang-MSFT
  • 522
  • 3
  • 4
  • 5
    This information is not helpful since it does not describe which features in the sequence diagrams are supported. And actually flow charts are also supported but it is not clear what is supported as part of "Flow charts" supports. If the exact version would be known we could check in the release notes of mermaid itself for the supported features. – Marko Nov 16 '20 at 09:51
  • I tested this problem further, this seems to have nothing to do with the version. As long as it belongs to the Mermaid diagram types supported by the official document, then their features are supported. – Alina Wang-MSFT Nov 18 '20 at 06:33
  • 1
    Ok. That means since I was not using an officially supported diagram type (Flowchart) you cannot give any details? Can't you please forward this question to dev? They can answer this question in a matter of 5 mins and then I am also happy since I get the answer that I am seeking. – Marko Nov 18 '20 at 07:26
  • If you havent already, you should post this as an issue/question on the Mermaid github repo: https://github.com/mermaid-js/mermaid/issues. However, keep in mind that they will not be able to answer the question of which version is being used, since that is controlled by Azure. – Justin Greywolf Dec 10 '20 at 23:54
  • 2
    As an interesting side bit - while the page that @AlinaWang-MSFT points to does say only Sequence Diagrams and Gantt Charts are supported, the screenshot shows a Flowchart diagram ;) – Justin Greywolf Dec 10 '20 at 23:55
  • Another addition to this issue, mermaid support is only available on the cloud version of Azure DevOps currently, not on the on-premise version. – Wilko van der Veen Dec 15 '21 at 09:02
4

As of Sprint 200 (March 2022) the following diagrams are supported up to version 8.13.9:

  • Flowchart
  • Sequence diagrams
  • Gantt charts
  • Pie charts
  • Requirement diagrams
  • State diagrams
  • User Journey
Matthew Steeples
  • 7,858
  • 4
  • 34
  • 49
  • 3
    Huh, the release clearly states that those are supported. However, as soon as I change my chart type to Flowchart, rendering breaks, and a message is displayed instead: "Unsupported diagram type". – Bruno Brant Apr 01 '22 at 14:52
  • @BrunoBrant On [their documentation page](https://learn.microsoft.com/en-us/azure/devops/project/wiki/wiki-markdown-guidance?view=azure-devops#flowchart-example) they say: _We don't support `---->` or `flowchart` syntax, nor links to and from `subgraph`._ The substitute that seems to work as of today is `graph`. – Mariusz Ignatowicz Jun 04 '22 at 10:20
  • 1
    @Mattew Steeples Trouble is, their documentation does not match the actual functionality - pie charts, state diagrams, and user journeys still do not render. I have asked the team about it. They were responsive at first, but now have ghost the inquiry for a date. The "in a few weeks" statement in the release notes is clearly inaccurate. – one.beat.consumer Jun 14 '22 at 17:07
3

As a workaround, you can actually use any type of diagram in Azure DevOps using embedded markdown links. From the mermaid live editor, expand the "Actions" section and click on "COPY MARKDOWN" button:

enter image description here

output: enter image description here

This relies on the mermaid.ink webservice so it's not entirely reliable.

adrien
  • 504
  • 1
  • 7
  • 17
  • 2
    Thanks for the hint. But I fear I am not allowed to save/transfer company ip diagrams on some public mermaid server. – Marko Apr 27 '23 at 07:07
  • This is gold! But I am afraid it will be cumbersome to maintain the updates in future for complex diagrams. – sud007 May 05 '23 at 10:13
  • I was wrong when I tried it actually as long as `mermaid.ink` service is working. Add your diagram to Wiki as markdown. In future just tap on the diagram and it will open the mermaid editor for you! Voila! – sud007 May 05 '23 at 10:20
2

I looked at the files downloaded from the Developer Tools: Network tab. I first thought it was 6.3 based upon the url but looking into the json I saw this...

"./package.json":function(e){e.exports={name:"mermaid",version:"8.2.3",description:"Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",main:"dist/mermaid.core.js",keywords:["diagram","markdown","flowchart","sequence diagram","gantt","class diagram","git graph"]

So as of this moment... I believe it to be 8.2.3

T Brown
  • 1,385
  • 13
  • 9
2

Sad that azure devops (server) wiki still not support mermaid.

One hack could be using the 'markdown' button on https://mermaid.live/ and then paste the markdown from mermaid.live into devops wiki.

Nielsen
  • 23
  • 3
0

UPDATE From this release, all the diagram types in the following list are supported:

  • Sequence diagrams
  • Gantt charts
  • Flowcharts
  • Pie charts
  • Requirement diagrams
  • State diagrams
  • User Journey

--- Original Post ---

Checking the listed support page it shows the following diagrams as supported:

Supported:

  • Sequence diagrams
  • Gantt charts
  • Flowcharts

Unsupported:

  • Pie charts
  • Requirement diagrams
  • State diagrams
  • User Journey

Testing each of the diagram types in a DevOps wiki page using the examples from the mermaid website, the first three work. The rest return an error "Unsupported diagram type". Truly amazing they have it documented as supported but in reality its not.

Jim
  • 692
  • 7
  • 15
  • I have tried personally and discovered that, all except ER and Mermaid are supported! – sud007 May 05 '23 at 10:14
  • This is due to a recent release that enabled more of the diagram types. https://learn.microsoft.com/en-us/azure/devops/release-notes/2022/wiki/sprint-200-update – Jim May 08 '23 at 17:55
  • This answer needs update hence! – sud007 May 11 '23 at 18:16