Diagram as Code: PlantUML and Mermaid-Js

  • 5 September 2022
  • 15 replies
  • 1944 views

Userlevel 5

Hello Community,

 

We’re excited to announce that you can now create diagrams using code with Mermaid and PlantUML apps right in Miro. 

 

With these apps you can automate the process of generating complex diagrams with a simple text language — so you don’t have to worry about design and layout.

  • No need to align diagrams or manually update designs — design and layout are automatically applied

  • Copy your diagram code from other sources like GitHub or Notion to automatically re-create your diagram in Miro

  • Visit the Marketplace to install Mermaid and PlantUML 

  • Note, in this first version code will generate an image. We’re curious to hear your feedback and input for the next version

Visit our Help Center to learn more:

Share your ideas or work with the Miro Community and inspire others.

Happy Diagramming,

Turner 


15 replies

Userlevel 2

Hi Turner, Thank you for the details. this is amazing to get PlantUML support in Miro. 

Is there any way I can modify a plantUML diagram after it has been added to the board.

Userlevel 5

Hi Arijt, thank you for your feedback. In this first version that’s not yet possible. But we’re taking in feedback from the Community, so glad you mentioned this!

Best,

Turner

Userlevel 2

Thanks Turner for the details. Will the code be available in any repo to go through?

Would love to have the ability to export diagrams from Miro to Mermaid code so we can backup some of our important diagrams and version them.

But awesome work!

Userlevel 1

Would be great if the code/syntax was kept, and could edited on the board, updating the image on the fly.

Would really help with collaborating around problems/ideas.

Great start though! 👍🏻

This is an awesome feature! Thank you.

Also, I agree with @Timothy Connolly. One of the main advantages of mermaid is making diagrams easy to change - solves the `Doc-Rot Catch 22` as the mermaid team highlight. I would use this if I could easily edit the mermaid code for the diagram.

FWIW, draw.io let’s you do this by double clicking on the created image to edit the underlying mermaid code:

More details at https://www.diagrams.net/blog/mermaid-diagrams

Userlevel 1

+1 to editing, it would be a great alternative to draw.io if the diagrams were mutable

Hi,

I’m considering asking for the PlantUML miro app to be authorised for use in our company. However it would be good to know where your rendering service sits.

Do you have your own private rendering service which takes the PlantUML code and creates the image without the PlantUML code (i.e. data) leaving your domain or do you use a public rendering server?

Thanks in advance,

Terry.

another +1 to editing!

Userlevel 5

Hi @Terry MR 

We host our own PlantUML rendering service, no data leaves our infrastructure.

Hope this is helpful,

Turner 

Hi @Turner Pijpers ,

very excited by the mermaid app!

A couple of things:

  1. definitely need the edit functionality, I already got pretty mad at forgetting to copy-paste my diagram in a notepad before hitting “add to board” 😞
  2. the resolution of the image being added to the board is not high enough for complex/long sequence diagrams with a lot of information - the labels become unreadable when zooming in

Thank you!

Iacopo

Userlevel 4

@Turner Pijpers if it’s not documented already, you should include that information on hosting PlantUML in the documentation to help those that are reviewing the plugin for a later date.

 

Edit - NVM. Answered already. PlantUML rendering is on Miro services!

+1 for click-to-edit as a feature request. Mermaid.js integration is great, but not practically useful unless we can edit.

This is totally useless without storing source and editing

Reply