Warm tip: This article is reproduced from stackoverflow.com, please click
github Markdown readme mermaid

How to install Mermaid to render flowcharts in markdown?

发布于 2020-04-11 11:44:17

I'm trying to render a flowchart in a markdown file using Mermaid. I have a ReadMe.md file in my GitHub repository, and I'd like to include a basic flowchart to help describe the contents. But I can't figure out how to get it to work. Would someone be able to post some more specific instructions on how to render a simple example?

In this link (https://unpkg.com/mermaid@8.0.0-rc.8/README.md), there's an example code snippet for the Mermaid installation:

    ```
    https://unpkg.com/mermaid@7.1.0/dist/
    ```

I included that code, then tried to make the flowchart in the next code snippet:

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

But all it does is print that text out in the markdown file when I preview it.

It seems like it's possible based on the Mermaid ReadMe: https://github.com/knsv/mermaid/blob/master/README.md. But when I looked at the code it's actually a picture of the flowchart, not a rendering of code. So maybe what I'm asking isn't possible?

Would appreciate any help!

Questioner
AlexP
Viewed
123
Jannik Buhr 2018-08-28 19:37

Unfortunately, github-flavoured markdown doesn't support rendering of mermaid graphs. See this issue for more information and finding comfort in other peoples quest of this feature ;)

If your are using VS Code, you can use this extension to preview your mermaid code blocks inside markdown but note that this does not render once you put it on github. To include the chart on github you will have to render it to a file, though someone suggested somehow using the online mermaid editor to render it and retrieve an URL to a rendered version.

Actually, let me try to insert the example chart from the link on the previousely mentioned page... and, no. We get a Failed to upload image; the format is not supported-error.

So you will need to save it as an image first.