mermaid/docs/Tutorials.md

67 lines
2.0 KiB
Markdown
Raw Normal View History

# Tutorials
2020-08-22 03:41:57 +02:00
This is list of publicly available Tutorials for using Mermaid.JS . This is intended as a basic introduction for the use of the Live Editor for generating diagrams, and deploying Mermaid.JS through HTML.
2020-10-28 08:20:35 +01:00
2021-03-06 09:33:21 +01:00
**Note that these tutorials might display an older interface, but the usage of the live-editor will largely be the same.
For most purposes, you can use the [Live Editor](https://mermaid-js.github.io/mermaid-live-editor), to quickly and easily render a diagram.
2020-08-22 03:41:57 +02:00
## Live-Editor Tutorials
The definitions that can be generated the Live-Editor are also backwards-compatible as of version 8.7.0.
2020-08-22 03:41:57 +02:00
[GitLab Unfiltered: How to Create Mermaid Diagrams](https://www.youtube.com/watch?v=SQ9QmuTHuSI&t=438s)
2020-08-22 03:41:57 +02:00
[GitLab Unfiltered: Emilie adds a mermaid diagram to the handbook](https://www.youtube.com/watch?v=5RQqht3NNSE)
2020-08-22 03:41:57 +02:00
[World of Zero: I Learn How To Build Flowcharts and Signal Diagram's in Mermaid.JS](https://www.youtube.com/watch?v=7_2IroEs6Is&t=207s)
2020-08-22 03:41:57 +02:00
[Eddie Jaoude: Can you code your diagrams?](https://www.youtube.com/watch?v=9HZzKkAqrX8)
2020-08-22 03:41:57 +02:00
2020-11-05 19:16:12 +01:00
## Mermaid with HTML
Examples are provided in [Gettting Started](n00b-gettingStarted.md)
2020-08-22 03:41:57 +02:00
**CodePen Examples:**
2020-08-22 03:41:57 +02:00
https://codepen.io/CarlBoneri/pen/BQwZzq
https://codepen.io/tdkn/pen/vZxQzd
https://codepen.io/janzeteachesit/pen/OWWZKN
2020-11-05 19:16:12 +01:00
## Mermaid with Text Area
2020-08-22 03:41:57 +02:00
https://codepen.io/Ryuno-Ki/pen/LNxwgR
## Python Integration with mermaid-js
Here's an example of python integration with mermaid-js which uses the mermaid.ink service.
This is also working with colab and jupyter lab notebooks.
```python
import base64
import requests, io
from PIL import Image
import matplotlib.pyplot as plt
graph = """
graph LR;
A--> B & C & D;
B--> A & E;
C--> A & E;
D--> A & E;
E--> B & C & D;
"""
graphbytes = graph.encode("ascii")
base64_bytes = base64.b64encode(graphbytes)
base64_string = base64_bytes.decode("ascii")
img = Image.open(io.BytesIO(requests.get('https://mermaid.ink/img/' + base64_string).content))
plt.imshow(img)
```
**Output**
![image](img/python-mermaid-integration.png)