> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/help-center/integrations/integrations-troubleshooting/why-is-the-mermaid-block-not-loading.md).

# Why is the Mermaid block not loading?

Mermaid is now a native block in GitBook. You don’t need to install or enable an integration to use it.

If your Mermaid diagram isn’t loading, check these common causes:

### Check your Mermaid syntax

Syntax errors can stop the native Mermaid block from rendering.

1. Review your Mermaid code for typos or missing characters.
2. Compare it with examples in the Mermaid documentation.
3. Test it in the Mermaid Live Editor if you want to isolate the issue.

### Ensure that you are using a Mermaid block (and not a code block)

The native Mermaid block and a standard code block work differently. Mermaid code won’t render inside a standard code block.

To add a Mermaid block:

1. Press `/`.
2. Select **Mermaid diagram**.

<figure><img src="/files/QPNgKQKte9XdJkq3wYCf" alt=""><figcaption><p>Mermaid block selection in the GitBook editor</p></figcaption></figure>

### Working with older Mermaid blocks

If you created Mermaid content before native block support, GitBook converts older Mermaid blocks automatically the next time you edit the page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/help-center/integrations/integrations-troubleshooting/why-is-the-mermaid-block-not-loading.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.