Loading mermaid diagrams from external files

[Krever]

Problem

When trying to use mermaid theme (as described here) and load the diagrams from file using remark-code-snippets (as suggested here) the snippets are not rendered. Instead an error is shown:

No diagram type detected matching given configuration for text: 

Cause

The problem is because of the remark plugins loading order: mermaid is loaded before options.remarkPlugins here.

Solution

The solution is to use remark-code-snippets through beforeDefaultRemarkPlugins instead of remarkPlugins.

Context

I'm posting it here for the sake of anyone hitting the same problem in the future.
Also, feel free to suggest alternative approaches/solutions, as I'm a very casual docosaurus user.

[slorber]

Yes, plugin ordering may matter in some cases, one relying on the other's output.
We plan to give you more control over the order in the future with upcoming APIs.