Skip to main content
Idea

Convert Mermaid diagrams to editable shapes

Related products:Lucidchart
  • February 6, 2026
  • 4 replies
  • 639 views

Forum|alt.badge.img

Hello Lucid Support Team,

I’m running into an issue with a diagram created using Diagram as Code (Mermaid) that I’m unable to resolve, and I’d appreciate guidance on whether this is a product limitation or a configuration issue.

Goal
I want to convert an existing Mermaid-based diagram into fully editable native Lucidchart shapes (so individual boxes, connectors, and containers can be selected and edited without touching Mermaid code).

Current State

  • The diagram was created using Diagram as Code (Mermaid).

  • Clicking the diagram always selects it as a single object and opens the Mermaid editor.

  • Individual shapes and connectors are not directly editable.

What I’ve Tried

  1. Right-clicking the diagram and checking for:

    • “Convert to shapes”

    • “Detach from diagram as code”
      → These options do not appear.

  2. Keyboard shortcuts:

    • Ctrl+Shift+V (Paste special)
      → No prompt appears; nothing happens.

  3. Copy → Paste within the same document:

    • No option to paste as shapes.

  4. Checking top menus and contextual toolbars:

    • No visible option to convert or detach from Mermaid.

  5. Verifying selection:

    • The diagram always behaves as a single Diagram-as-Code object.

Observed Limitation
It appears that in my Lucid environment / tenant:

  • Mermaid diagrams cannot be converted into native shapes

  • There is no exposed “convert” or “paste as shapes” workflow

  • Diagram-as-Code objects are effectively locked to code-only editing

Question

  • Is this behavior expected for certain plans or tenant configurations?

  • Is there an official way to convert Mermaid diagrams into native Lucidchart shapes in this environment?

  • If not, is recreating the diagram manually the only supported path?

I’ve attached screenshots showing:

  • The Mermaid editor opening when the diagram is selected

  • The absence of any “Convert to shapes” or “Paste as shapes” options

Thanks in advance for your help and clarification.

May 1, 2026

Hi ​@kurtastbury, thank you for your comment here! 

At this time, converting Mermaid diagrams into editable shapes is not currently supported in Lucid. A diagram generated from code is displayed as an image on the canvas and must be updated by opening and editing the code.

We’re very interested in your feedback and committed to continually improving our products. This post is logged as feedback and our product teams regularly review comments like yours in this space as they research new enhancements and product features. Thanks for showing your support for this feature and letting us know that it’s something you’d like to see!

We encourage anyone else who’s interested in this to upvote this post and share any additional details about your use case or what you’d like to see in this experience. 

For more information about how we manage feedback in this community, please take a look at this post:

 

Comments

Kyler G
Forum|alt.badge.img+3
  • Lucid product team
  • February 6, 2026

Hello,
Unfortunately the Diagram as code feature does not allow you to edit the diagram as individual shapes, instead it creates an SVG that we use to display the mermaid diagram. 

A potential workaround is to copy the mermaid code into Lucid AI and then have it create the shapes in the document. You would then be able to modify them. 

We have had discussions about implementing a feature like you described and appreciate the detailed request. We will pass it along to the relevant teams. 

Kyler
 


Hello ​@marshall_boostcx, my name is Vera and I am on the Product team at Lucid. Our teams are currently looking into our Diagram as Code feature and specifically converting mermaid diagrams to editable shapes. I would love to ask you a few questions about your requirement as we’re actively doing research. Would you be willing to jump on a brief call with me? Here’s a direct link for scheduling: https://calendly.com/lucid-software/lucid-research-mermaid


Forum|alt.badge.img

@Vera Toncheva Product at Lucid can you tell me if this feature is available?  I am also trying to convert mermaid files into editable shapes.


Ambar D
Forum|alt.badge.img+12
  • Lucid community team
  • May 1, 2026

Hi ​@kurtastbury, thank you for your comment here! 

At this time, converting Mermaid diagrams into editable shapes is not currently supported in Lucid. A diagram generated from code is displayed as an image on the canvas and must be updated by opening and editing the code.

We’re very interested in your feedback and committed to continually improving our products. This post is logged as feedback and our product teams regularly review comments like yours in this space as they research new enhancements and product features. Thanks for showing your support for this feature and letting us know that it’s something you’d like to see!

We encourage anyone else who’s interested in this to upvote this post and share any additional details about your use case or what you’d like to see in this experience. 

For more information about how we manage feedback in this community, please take a look at this post: