Skip to content

Add Mermaid Diagrams to Your Astro JS Website

Updated: at 08:52 PM

Mermaid diagrams are a great way to visualize complex information on your website. In this blog post, we’ll walk you through the process of adding Mermaid diagrams to your Astro JS website, step by step.

The first step is to install the Remark Mermaid library. You can do this using npm:

npm install remark-mermaidjs

In Node.js this package uses playwright under the hood. To use it, you may need to install additional dependencies. These can be installed with:

npx playwright install --with-deps chromium

Add remarkMermaid pluggin to remarkPlugins array in astro.config.mjs

import remarkMermaid from "remark-mermaidjs";

export default defineConfig({
  markdown: {
    remarkPlugins: [remarkMermaid],
  },
});

Finally, You can do this by adding a code block with the “mermaid” language identifier:

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

A
B
C
D

If your CSS controls SVG styles, you should disable styles from generated Mermaid diagrams.

svg:not([id^="mermaid"]) {
}

Build your Astro JS website and deploy it to see the Mermaid diagram in action on your website.

Conclusion: Adding Mermaid diagrams to your Astro JS website is a straightforward process that can enhance the visual appeal and effectiveness of your content. Follow the steps outlined in this blog post to start using Mermaid diagrams in your projects today!