# Mermaid markdown not displaying

**URL:** <https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717>\
**Category:** Gitea Usages\
**Created:** [December 5, 2020, 12:21am UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717 "2020-12-05T00:21:40Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![bak](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@bak](https://forum.gitea.com/u/bak)\
**Post date:** [December 5, 2020, 12:21am UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717/1 "2020-12-05T00:21:40Z")

</div>

I see that the [mermaid.js](https://mermaid-js.github.io/mermaid/#/) library was added to gitea v 1.13. Is anybody able to get this working?

For example, I thought all I had to do was include markdown like this:

> mermaid
> 
> stateDiagram  
> [\*] → Active
> 
> state Active {  
> [\*] → NumLockOff  
> NumLockOff → NumLockOn : EvNumLockPressed  
> NumLockOn → NumLockOff : EvNumLockPressed
> 
> }

and it should display a nice looking mermaid chart. Instead, I just see the block being displayed as if it were code.

Is anybody else having this issue?

---

<div class="post-metadata">

**Author:** ![matm](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/matm/32/1049_2.png) [@matm](https://forum.gitea.com/u/matm)\
**Post date:** [December 6, 2020, 7:42am UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717/2 "2020-12-06T07:42:37Z")

</div>

Just tried on a wiki page in v1.13, it works pretty well:

```mermaid  
graph TD  
Start --\> End  
```

Then hit the “Preview” button to see the graph.

---

<div class="post-metadata">

**Author:** ![bak](https://avatars.discourse-cdn.com/v4/letter/b/a587f6/32.png) [@bak](https://forum.gitea.com/u/bak)\
**Post date:** [December 6, 2020, 3:33pm UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717/3 "2020-12-06T15:33:08Z")

</div>

Aha! Thanks for confirmation that it works.

Turns out my problem was that I had a custom markdown configuration that uses pandoc to render markdown. Once removed, mermaid now works…now I just have to remember why I was using pandoc in the first place!

---

<div class="post-metadata">

**Author:** ![johndevs](https://avatars.discourse-cdn.com/v4/letter/j/ac91a4/32.png) [@johndevs](https://forum.gitea.com/u/johndevs)\
**Post date:** [June 29, 2026, 8:09am UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717/4 "2026-06-29T08:09:32Z")

</div>

Hi,

I have `.mmd` files in my project and was hoping they also would display properly.

According the mermaid.js `.mmd` and .`mermaid` are officially supported file extensions

`Applications that support Mermaid files `[`SHOULD`](https://datatracker.ietf.org/doc/html/rfc2119#section-3)` use .mermaid or .mmd file extensions.`  
([Integrations - create | Mermaid](https://mermaid.ai/open-source/ecosystem/integrations-create.html))

However, when I select a `.mmd` file in the web UI it is shown as text, not rendered.

Would be nice to support this as inlining large mermaid charts inside Markdown is cumbersome.

---

<div class="post-metadata">

**Author:** ![marcoroenfeldtdeutz](https://avatars.discourse-cdn.com/v4/letter/m/b9e5f3/32.png) [@marcoroenfeldtdeutz](https://forum.gitea.com/u/marcoroenfeldtdeutz)\
**Post date:** [September 7, 2026, 3:40pm UTC](https://forum.gitea.com/t/mermaid-markdown-not-displaying/2717/5 "2026-09-07T15:40:55Z")

</div>

Hi,

got the same issue. The wiki page is unfortunately not gitops compatible

would be greate of .mmd files could be rendered in the code repo web UI