# Say hello to Mermaid Diagrams 👋

**URL:** <https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948>\
**Category:** Plugins\
**Tags:** design, mermaid, charts\
**Created:** [October 8, 2026, 3:06pm UTC](https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948 "2026-10-08T15:06:09Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![elenatorro](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/elenatorro/32/7407_2.png) [@elenatorro](https://community.penpot.app/u/elenatorro)\
**Post date:** [October 8, 2026, 3:06pm UTC](https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948/1 "2026-10-08T15:06:09Z")

</div>

I’ve been a Mermaid fan for years, so I wanted to bring a plugin to Penpot to be able to work with Mermaid Diagrams.

> **[Penpot Plugin | Mermaid Diagrams](https://penpot.app/penpothub/plugins/mermaid-diagrams)**
>
> Turn Mermaid diagrams into editable Penpot shapes

It’s pretty basic, these are the current features:

- Diagrams are built from Penpot text, paths and shapes, so you can edit and export them like anything else in your file.
- Live preview with syntax highlighting while you type.
- A list of starter templates and themes, including a custom style example.
- Plugin’s window follows Penpot’s light and dark theme

 ![mermaid_plugin_2](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/4/430ff566f67bb042440391d98d7ee9b69b5d2952.png)

 ![mermaid_plugin_1](https://europe1.discourse-cdn.com/flex017/uploads/penpot/original/2X/0/09294c263b669fea1c525c0939eb397298290867.png)

The code is on GitHub: [GitHub - elenatorro/penpot-mermaid-plugin: Mermaid schemas for Penpot · GitHub](https://github.com/elenatorro/penpot-mermaid-plugin) .

Feedback, ideas and bug reports are very welcome!

---

<div class="post-metadata">

**Author:** ![LauraKalbag](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/laurakalbag/32/5014_2.png) [@LauraKalbag](https://community.penpot.app/u/LauraKalbag)\
**Post date:** [October 9, 2026, 8:18am UTC](https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948/2 "2026-10-09T08:18:03Z")

</div>

> [@elenatorro](#):
>
> It’s pretty basic

Says this and then goes on to list a load of really cool non-basic features 😆

This will be so useful for UX design and other planning work, thank you so much for making and sharing it!

---

<div class="post-metadata">

**Author:** ![dfelinto](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/dfelinto/32/380_2.png) [@dfelinto](https://community.penpot.app/u/dfelinto)\
**Post date:** [October 9, 2026, 9:42am UTC](https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948/3 "2026-10-09T09:42:29Z")

</div>

This is pretty cool. We use mermaid a lot too and I can totally see myself using this to mix mockups and more technical visuals!

---

<div class="post-metadata">

**Author:** ![alvar](https://avatars.discourse-cdn.com/v4/letter/a/a9adbd/32.png) [@alvar](https://community.penpot.app/u/alvar)\
**Post date:** [October 13, 2026, 8:35am UTC](https://community.penpot.app/t/say-hello-to-mermaid-diagrams/10948/4 "2026-10-13T08:35:51Z")

</div>

This is really cool.

Since Penpot allows repositioning, it may help with the problem of “I don’t like where Mermaid put the boxes”.

On the other hand, perhaps something like [GitHub - reladraw/reladraw · GitHub](https://github.com/reladraw/reladraw) ([why?](https://github.com/reladraw/reladraw#why-not-mermaid-or-drawio)) would make for a better starting point for those wanting to tweak. In particular, those diagrams might require less arrow re-routingwhen moving boxes around.

Once the infrastructure input box, previw, update, “export”) is there thanks to @elenatorro, offering other diagram layout engines suddenly seems much more approachable! ❤
