<!--IssueSummary start--> <details> <summary> Everyone can contribute. [Help move this issue forward](https://handbook.gitlab.com/handbook/marketing/developer-relations/contributor-success/community-contributors-workflows/#contributor-links) while earning points, leveling up and collecting rewards. </summary> - [Close this issue](https://contributors.gitlab.com/manage-issue?action=close&projectId=278964&issueIid=362442) </details> <!--IssueSummary end--> The correct way to call in restructured-text a mermaid directive is: ``` .. mermaid:: sequenceDiagram participant Alice participant Bob Alice->John: Hello John, how are you? ``` This syntax is not took into account by gitlab rst render engine. Cf. https://gitlab.com/LuisArturo/sphinxcontrib-mermaid/-/blob/master/README.rst