# Mermaid: Support Elk layout system in core Obsidian

**URL:** <https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700>\
**Category:** Feature requests\
**Tags:** mermaid\
**Created:** [January 30, 2025, 7:45pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700 "2025-01-30T19:45:06Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![pedro16090](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/p/a5b964/32.png) [@pedro16090](https://forum.obsidian.md/u/pedro16090)\
**Post date:** [January 30, 2025, 7:45pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/1 "2025-01-30T19:45:06Z")

</div>

Hello, first of all, I’d like to apologize for any mistakes in my writing, as English is not my native language. I’d like to request something that I believe is a common wish among a large part of the community that uses Mermaid diagrams: the ability to use theme and layout configurations, such as Elk. This would be essential to make this native feature even more powerful and to ensure that the visualization in the online editor matches the visualization in Obsidian.

 ![image](https://forum.obsidian.md/uploads/default/original/3X/e/4/e477b10f943e456fb077fe26ef053e3639b6a9ff.png)

---

<div class="post-metadata">

**Author:** ![Sigrunixia](https://forum.obsidian.md/user_avatar/forum.obsidian.md/sigrunixia/32/52395_2.png) [@Sigrunixia](https://forum.obsidian.md/u/Sigrunixia)\
**Post date:** [January 31, 2025, 1:05am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/2 "2025-01-31T01:05:25Z")

</div>

Mermaid in Obsidian does support inline theming with the default configurations, as well as declared configurations within the codeblock.

> **[Theme Configuration | Mermaid](https://mermaid.js.org/config/theming.html)**
>
> Create diagrams and visualizations using text and code.

Where does “Elk” come from?

---

<div class="post-metadata">

**Author:** ![pedro16090](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/p/a5b964/32.png) [@pedro16090](https://forum.obsidian.md/u/pedro16090)\
**Post date:** [February 4, 2025, 1:58pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/3 "2025-02-04T13:58:50Z")

</div>

A different form of layout, such as that shown in the image, where the standard layout is not used.

Link: [Flowcharts Syntax | Mermaid](https://mermaid.js.org/syntax/flowchart.html#configuration)

---

<div class="post-metadata">

**Author:** ![nanoant](https://forum.obsidian.md/user_avatar/forum.obsidian.md/nanoant/32/76811_2.png) [@nanoant](https://forum.obsidian.md/u/nanoant)\
**Post date:** [February 10, 2025, 2:45pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/4 "2025-02-10T14:45:47Z")

</div>

OP is asking to provide ELK layout engine support that is no longer included in main minified JS of Mermaid since 11.0 (see v11.0.0 release notes) and sites/apps must install `@mermaid-js/layout-elk` see mermaid-js/mermaid#5049

I’ve created similar “feature request” that is actually regression for Typora here typora/typora-issues#6174 that also explains how to build single JS with ELK for Mermaid \>11.0.

I’d appreciate if Obsidian team looks into including ELK, as it is substantially improving complex graphs and is relatively simple fix (see recipe from Typora issue report). We rely strongly on ELK in my team, and folks using Obsidian no longer can render documentation properly.

Thank you, Adam

P.S. I wish I could included links to GitHub issues and release notes, but your forum does not allow me to do so.

---

<div class="post-metadata">

**Author:** ![pedro16090](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/p/a5b964/32.png) [@pedro16090](https://forum.obsidian.md/u/pedro16090)\
**Post date:** [February 10, 2025, 6:46pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/5 "2025-02-10T18:46:38Z")

</div>

That’s right. I think the colleague was able to better describe the addition (or return, since after the last major update the feature stopped working).

---

<div class="post-metadata">

**Author:** ![nanoant](https://forum.obsidian.md/user_avatar/forum.obsidian.md/nanoant/32/76811_2.png) [@nanoant](https://forum.obsidian.md/u/nanoant)\
**Post date:** [February 17, 2025, 11:38am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/6 "2025-02-17T11:38:50Z")

</div>

Referencing the issues from my post above as I am now allowed to put links here:

- [Move ELK to standalone package by sidharthv96 · Pull Request #5049 · mermaid-js/mermaid · GitHub](https://github.com/mermaid-js/mermaid/pull/5049)
- [Mermaid flowchart-elk no longer works in 1.10.2-dev · Issue #6174 · typora/typora-issues](https://github.com/typora/typora-issues/issues/6174)
- [Provide minified bundle with ELK for desktop/standalone Markdown editors · Issue #6294 · mermaid-js/mermaid](https://github.com/mermaid-js/mermaid/issues/6294)

---

<div class="post-metadata">

**Author:** ![harr](https://forum.obsidian.md/user_avatar/forum.obsidian.md/harr/32/68498_2.png) [@harr](https://forum.obsidian.md/u/harr)\
**Post date:** [March 15, 2025, 8:42pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/7 "2025-03-15T20:42:47Z")

</div>

ELK = Eclipse Layout Kernel: [https://eclipse.dev/elk/](https://eclipse.dev/elk/)

How to select in Mermaid: [https://mermaid.js.org/intro/syntax-reference.html#customizing-elk-layout](https://mermaid.js.org/intro/syntax-reference.html#customizing-elk-layout)

---

<div class="post-metadata">

**Author:** ![janshi](https://forum.obsidian.md/user_avatar/forum.obsidian.md/janshi/32/29505_2.png) [@janshi](https://forum.obsidian.md/u/janshi)\
**Post date:** [April 16, 2025, 7:38am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/8 "2025-04-16T07:38:50Z")

</div>

I use mermaid to visualize ideas for software architectures and having ELK would help a lot with complex setups  
+1

---

<div class="post-metadata">

**Author:** ![bcardiff](https://forum.obsidian.md/user_avatar/forum.obsidian.md/bcardiff/32/52157_2.png) [@bcardiff](https://forum.obsidian.md/u/bcardiff)\
**Post date:** [May 15, 2025, 8:05pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/9 "2025-05-15T20:05:59Z")

</div>

The patch from [Mermaid flowchart-elk no longer works in 1.10.2-dev · Issue #6174 · typora/typora-issues · GitHub](https://github.com/typora/typora-issues/issues/6174#issuecomment-2493578253) provided by @nanoant is great!

Can we pretty please have elk support in obsidian? Or at least, does anyone know of a plugin that could override the core support of mermaid with something that has elk support?

---

<div class="post-metadata">

**Author:** ![Grallen](https://forum.obsidian.md/user_avatar/forum.obsidian.md/grallen/32/81806_2.png) [@Grallen](https://forum.obsidian.md/u/Grallen)\
**Post date:** [June 26, 2025, 3:58am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/10 "2025-06-26T03:58:22Z")

</div>

Yes, I agree. Please support this.

---

<div class="post-metadata">

**Author:** ![Eneswar](https://forum.obsidian.md/user_avatar/forum.obsidian.md/eneswar/32/53503_2.png) [@Eneswar](https://forum.obsidian.md/u/Eneswar)\
**Post date:** [September 8, 2025, 9:10pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/11 "2025-09-08T21:10:28Z")

</div>

Adding my support for this, please add layout support.

---

<div class="post-metadata">

**Author:** ![stakazi](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/s/8e8cbc/32.png) [@stakazi](https://forum.obsidian.md/u/stakazi)\
**Post date:** [September 9, 2025, 10:49pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/12 "2025-09-09T22:49:13Z")

</div>

I would love to see it added to obsidian. So sad, we cannot just make a Pull Request with this addtion. It is more or less a oneliner - add the @mermaid-js/layout-elk as dependency and import it…

---

<div class="post-metadata">

**Author:** ![Loxley](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/l/85e7bf/32.png) [@Loxley](https://forum.obsidian.md/u/Loxley)\
**Post date:** [September 12, 2025, 1:19pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/13 "2025-09-12T13:19:59Z")

</div>

I’d love to see this as well. 👍

---

<div class="post-metadata">

**Author:** ![h2ash](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/h/9de053/32.png) [@h2ash](https://forum.obsidian.md/u/h2ash)\
**Post date:** [October 2, 2025, 1:40pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/14 "2025-10-02T13:40:42Z")

</div>

+1 to have it

---

<div class="post-metadata">

**Author:** ![vitality](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/v/ac8455/32.png) [@vitality](https://forum.obsidian.md/u/vitality)\
**Post date:** [October 5, 2025, 9:25am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/15 "2025-10-05T09:25:16Z")

</div>

Would be awesome to have it

---

<div class="post-metadata">

**Author:** ![Guntz](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/g/ecccb3/32.png) [@Guntz](https://forum.obsidian.md/u/Guntz)\
**Post date:** [January 1, 2026, 8:46pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/16 "2026-01-01T20:46:15Z")

</div>

Just created an account to request this feature. This would be incredibly helpful, any moderately complex diagrams are pretty much unusable without ELK.

---

<div class="post-metadata">

**Author:** ![zombieanna](https://forum.obsidian.md/user_avatar/forum.obsidian.md/zombieanna/32/88458_2.png) [@zombieanna](https://forum.obsidian.md/u/zombieanna)\
**Post date:** [January 8, 2026, 8:03pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/17 "2026-01-08T20:03:56Z")

</div>

Adding my vote as well. Please add Elk. It’s so much easier to digest Mermaid Flowcharts and Entity-Relationship diagrams with this layout available. It would greatly improve the inline use of mermaid.

---

<div class="post-metadata">

**Author:** ![zhens](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/z/e36b37/32.png) [@zhens](https://forum.obsidian.md/u/zhens)\
**Post date:** [February 9, 2026, 5:16am UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/18 "2026-02-09T05:16:46Z")

</div>

Adding my vote as well. Native ELK support would make flowchart rendered by mermaid so much more readable.

---

<div class="post-metadata">

**Author:** ![hwrdsn](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/h/35a633/32.png) [@hwrdsn](https://forum.obsidian.md/u/hwrdsn)\
**Post date:** [February 10, 2026, 5:13pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/19 "2026-02-10T17:13:03Z")

</div>

+1  
Even medium-sized diagrams look terrible without elk.

---

<div class="post-metadata">

**Author:** ![reini](https://forum.obsidian.md/user_avatar/forum.obsidian.md/reini/32/30281_2.png) [@reini](https://forum.obsidian.md/u/reini)\
**Post date:** [February 11, 2026, 1:46pm UTC](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700/20 "2026-02-11T13:46:31Z")

</div>

+1  
I would also like to see ELK support.  
Thanks in advance.

[Next page](https://forum.obsidian.md/t/mermaid-support-elk-layout-system-in-core-obsidian/95700.md?page=2)
