Skip to main content
Seeking Feedback

How do you want to use Mermaid diagram-as-code in Lucidchart?

Related products:Lucidchart
  • June 9, 2026
  • 9 replies
  • 888 views

Forum|alt.badge.img+1

Hello Lucid Community members!

 

I’m a product manager for a team working on Mermaid diagram-as-code in Lucidchart. 

As we build better support for Mermaid in Lucidchart, we want to understand how you use Mermaid in your workflow, where Lucidchart is currently involved in that workflow, and how we can improve so that Lucidchart can be integrated more seamlessly into your workflow.

 

Goals:

  • Understand how and why you use Mermaid diagram-as-code
  • See if/how Lucid is currently used in your work with Mermaid
  • Learn how Lucid could improve your diagram-as-code workflow
  • Collect feedback on what you would ideally be able to do with Mermaid in Lucidchart

 

💡 Some Discussion Starters 💡

 

🧜‍♂️ Where is the initial mermaid code coming from? 

  • Is it committed to your repository?  
  • Are you using a tool to generate it?

🧜‍♂️ Once the mermaid is imported into Lucidchart, what types of things do you hope to be able to do with it?  

  • Add and delete shapes and lines?
  • Change colors and styling?
  • Modify layout?

🧜‍♂️ Once the diagram looks the way you want it to in Lucid, what do you want to be able to do with it? 

  • Share the diagram with someone else? 
  • Present to someone else?
  • Collaborate with other stakeholders? –  Name their titles.
  • Embed the diagram somewhere else?
  • Export and commit the modified mermaid code back into your repository?

🧜‍♂️ Which types of mermaid diagrams would you like to be able to use?

  • flowchart, sequence, class, ERD, state diagram, mindmap, C4 diagram, gantt, requirement diagram, user journey, pie chart, quadrant chart, gitgraph diagram, timeline
  • Are any of these diagrams more commonly used than others?

🧜‍♂️ What is the lifespan of the mermaid diagram? How is it being used again after the initial creation and collaboration?

  • Do you refer to it again in the future?
  • Is it used by others, and if so, how?
  • If the diagram isn’t used again, does the mermaid code in the repo get used/referred to in the future? When, why? (examples are welcome)

🧜‍♂️ What are the most painful aspects of this workflow? What is the single most painful aspect?

🧜‍♂️ What do you wish Lucid would change or improve to make this workflow better for you?

  • Rank your wishlist from most desirable to least desirable.

Comments

Ambar D
Forum|alt.badge.img+15
  • Lucid community team
  • June 9, 2026
Updated idea statusIdeaSeeking Feedback

Forum|alt.badge.img

Where is the initial mermaid code coming from? 

  • It starts as something that is generated from coding tools

Once the mermaid is imported into Lucidchart, what types of things do you hope to be able to do with it?  

  • I hope to be able to change the shapes and interact with it as if I had built it by hand in Lucid.

Once the diagram looks the way you want it to in Lucid, what do you want to be able to do with it?

  • I hope to be able to use all current functionality availble with diagrams I created in via the UI.

Which types of mermaid diagrams would you like to be able to use?

  • Flowchart would be the most useful to begin with.

What is the lifespan of the mermaid diagram? How is it being used again after the initial creation and collaboration?

  • I use it to get started with building the diagram so I don’t have to start from nothing.  I intend to update it and make it right after bringing it into Lucid.

What are the most painful aspects of this workflow? What is the single most painful aspect?

  • Currenly I have convert and import it as a .csv which is annoying and is somewhat lossy. 

What do you wish Lucid would change or improve to make this workflow better for you?

  • Add support for importing directly from Mermaid format to create new diagram.

 

 


Forum|alt.badge.img+1
  • Author
  • Lucid product team
  • June 15, 2026

Hi ​@kurtastbury!

Thank you so much for taking the time to respond to share your thoughts; this is exactly the type of feedback I’m looking for!

I'd love to dig into this with you more if you're open to it. Feel free to email me at egrundvig@lucidchart.com and we'll find a quick time to chat. Either way, thank you again for the thoughtful response!


Forum|alt.badge.img

🧜‍♂️ Where is the initial mermaid code coming from? 

I’m using Claude Code or Codex to create the initial mermaid diagram as it will get me 80% of the way to the full diagram much faster than creating it by hand. Claude Code / Codex has context on what I’m trying to do, so I prefer to start there instead of the Lucid AI.

 

🧜‍♂️ Once the mermaid is imported into Lucidchart, what types of things do you hope to be able to do with it?  

I’d like to further modify the diagram by moving shapes around, color-coding, and organizing the diagram.

 

🧜‍♂️ Once the diagram looks the way you want it to in Lucid, what do you want to be able to do with it? 

I’d want to link the diagram in a doc or PRD or similar for stakeholders to review and comment on.

 

🧜‍♂️ Which types of mermaid diagrams would you like to be able to use?

Flowchart would be most common

 

🧜‍♂️ What is the lifespan of the mermaid diagram? How is it being used again after the initial creation and collaboration?

For me, it would live in a PRD, so it would get referred to again through the development process.


Forum|alt.badge.img+1
  • Author
  • Lucid product team
  • June 25, 2026

Hi ​@hunter.dong,

Thank you so much for taking the time to share detailed feedback! Understanding your use case helps inform the features we bring to diagram-as-code in Lucidchart; we’re actively working on building out better support for similar use cases.


Forum|alt.badge.img

🧜‍♂️ Where is the initial mermaid code coming from? 

I’m using Claude Code or Codex. They have the structure and knowledge but generally make terrible diagrams. They always need hand-tweaking to be human readable. AI has no problem with them.

 

🧜‍♂️ Once the mermaid is imported into Lucidchart, what types of things do you hope to be able to do with it?  

Organize, modify, add. Essentially whatever I can do in Lucid

 

🧜‍♂️ Once the diagram looks the way you want it to in Lucid, what do you want to be able to do with it? 

I want to get it back out in Mermaid format. Our repositories use markdown. Your current export options are extremely limited. I can’t export to Plant or Mermaid which means I have to use other tools which are generally inferior to Lucid but at least I can get the changes back.

 

🧜‍♂️ Which types of mermaid diagrams would you like to be able to use?

All really. ERD, flowchart, swimlanes, DFD, etc

 

🧜‍♂️ What is the lifespan of the mermaid diagram? How is it being used again after the initial creation and collaboration?

It lives forever and gets edited often. AI will mangle them, I’ll have to fix them and then put back in the markdown file.


Forum|alt.badge.img
  • July 30, 2026

In alignment with ​@Marshall F.  Exactly similar needs.


Ambar D
Forum|alt.badge.img+15
  • Lucid community team
  • August 3, 2026

Thank you ​@Marshall F. and ​@adil for providing your feedback here in this thread! We’re very interested in your feedback and committed to continually improving our products. Thank you for being part of the feedback process at Lucid!

Additionally, if you’re interested in providing additional feedback and helping shape the future of Lucid products I recommend checking out our Lucid Legends program. Members of this program work directly with our product team to provide insights on features and improve the user experience. Learn more or enroll here


Forum|alt.badge.img
  • August 5, 2026

Hi Lucid team, 

Thanks for building these toolchain integration features!

All types of SDLC diagrams are in scope, with the corresponding notations (BPMN, UML, Archimate, ERD, etc.). Our intent is to seamlessly integrate human and tool/agentic diagram generation workflows.

Many diagrams end up embedded in Jira, Confluence, Word, or PowerPoint.

We’re using different tools / AI agents to generate mermaid code. Some of it gets committed to repositories; some gets generated from application source code in repos.

Most diagrams gets manually updated / refined as part of the HITL steps, shared, collaborated on, etc.

Human and automated workflows use mermaid diagram templates with styles for visual language continuity across the toolchain.

The Lucidchart diagram-as-code respects the style, but diagrams are not editable. Pasting mermaid on canvas currently loses styles but diagrams are editable.
.drawio is the most robust format but frequently requires a step in app.diagrams.net to fix compatibility issues when importing into Lucidchart.

It would be great to have insights into your toolchain roadmap so that we can align our approach with it (e.g. are you focusing on API, mermaid-centric, drawio/xml, all of the above, etc.).
Are you planning on providing mermaid templates for Copilot, Claude, etc. to generate Lucidchart-compliant mermaid code -or some other type of standard / Lucid proprietary format?
Would these templates support styles and notations? Could these templates be created graphically in Lucidchart and then exported in a format appropriate for agentic grounding?