Diagrams
Flowcharts, sequences, timelines, mind maps, Kroki, PlantUML and draw.io
Diagrams are written as text and drawn by the wiki. Change the text and the drawing follows. Most diagrams here use Mermaid: see mermaid.js.org for every kind.
Flowchart
For a decision or a procedure. --> draws an arrow, {...} a question, |Yes| a label on the arrow.
flowchart TD
A[Start of the meeting] --> B{Is it raining?}
B -->|Yes| C[Games in the hall]
B -->|No| D[Games in the courtyard]
C --> E[Closing prayer]
D --> E
::block-diagram{caption="Is it raining?" align="center"}
```mermaid
flowchart TD
A[Start of the meeting] --> B{Is it raining?}
B -->|Yes| C[Games in the hall]
B -->|No| D[Games in the courtyard]
C --> E[Closing prayer]
D --> E
```
::
[block-diagram, caption="Is it raining?", align="center"]
====
[source,mermaid]
----
flowchart TD
A[Start of the meeting] --> B{Is it raining?}
B -->|Yes| C[Games in the hall]
B -->|No| D[Games in the courtyard]
C --> E[Closing prayer]
D --> E
----
====
<block-diagram caption="Is it raining?" align="center">
<pre><code class="language-mermaid">flowchart TD
A[Start of the meeting] --> B{Is it raining?}
B -->|Yes| C[Games in the hall]
B -->|No| D[Games in the courtyard]
C --> E[Closing prayer]
D --> E</code></pre>
</block-diagram>
Timeline of a project
A Gantt chart shows the meetings of a project over the weeks.
gantt
dateFormat YYYY-MM-DD
title Lent journey
section Preparation
Plan the meetings :done, 2026-02-02, 7d
Prepare the materials :2026-02-09, 7d
section Meetings
Meeting 1 to 5 :2026-02-21, 35d
Easter celebration :milestone, 2026-04-05, 0d
::block-diagram{caption="Lent journey"}
```mermaid
gantt
dateFormat YYYY-MM-DD
title Lent journey
section Preparation
Plan the meetings :done, 2026-02-02, 7d
Prepare the materials :2026-02-09, 7d
section Meetings
Meeting 1 to 5 :2026-02-21, 35d
Easter celebration :milestone, 2026-04-05, 0d
```
::
[block-diagram, caption="Lent journey"]
====
[source,mermaid]
----
gantt
dateFormat YYYY-MM-DD
title Lent journey
section Preparation
Plan the meetings :done, 2026-02-02, 7d
Prepare the materials :2026-02-09, 7d
section Meetings
Meeting 1 to 5 :2026-02-21, 35d
Easter celebration :milestone, 2026-04-05, 0d
----
====
Mind map
For collecting ideas around a theme.
mindmap
root((Summer camp))
Games
Treasure hunt
Water games
Prayer
Morning prayer
Mass on Sunday
Trips
Mountain walk
::block-diagram{align="center"}
```mermaid
mindmap
root((Summer camp))
Games
Treasure hunt
Water games
Prayer
Morning prayer
Mass on Sunday
Trips
Mountain walk
```
::
[block-diagram, align="center"]
====
[source,mermaid]
----
mindmap
root((Summer camp))
Games
Treasure hunt
Water games
Prayer
Morning prayer
Mass on Sunday
Trips
Mountain walk
----
====
Sequence
Who does what, in order.
sequenceDiagram
participant P as Parent
participant O as Parish office
participant C as Catechist
P->>O: Hands in the signed form
O->>C: Confirms the enrolment
C-->>P: Sends the calendar
::block-diagram
```mermaid
sequenceDiagram
participant P as Parent
participant O as Parish office
participant C as Catechist
P->>O: Hands in the signed form
O->>C: Confirms the enrolment
C-->>P: Sends the calendar
```
::
[block-diagram]
====
[source,mermaid]
----
sequenceDiagram
participant P as Parent
participant O as Parish office
participant C as Catechist
P->>O: Hands in the signed form
O->>C: Confirms the enrolment
C-->>P: Sends the calendar
----
====
Kroki and PlantUML
These two draw the diagram on an outside server (kroki.io and plantuml.com), so the text of the diagram is sent there. Never put names of children in them.
Kroki draws Graphviz, D2, BPMN and about twenty more languages: set the language with type.
digraph G {
rankdir=LR
Oratory -> Little_ones
Oratory -> Middle
Oratory -> Teenagers
}
::block-kroki{type="graphviz" caption="Groups of the oratory"}
```kroki
digraph G {
rankdir=LR
Oratory -> Little_ones
Oratory -> Middle
Oratory -> Teenagers
}
```
::
[block-kroki, type="graphviz", caption="Groups of the oratory"]
====
[source,kroki]
----
digraph G {
rankdir=LR
Oratory -> Little_ones
Oratory -> Middle
Oratory -> Teenagers
}
----
====
PlantUML draws sequences, activities, mind maps and more.
@startuml
Parent -> Office : signed form
Office --> Parent : receipt
@enduml
::block-plantuml{caption="Enrolment"}
```plantuml
@startuml
Parent -> Office : signed form
Office --> Parent : receipt
@enduml
```
::
[block-plantuml, caption="Enrolment"]
====
[source,plantuml]
----
@startuml
Parent -> Office : signed form
Office --> Parent : receipt
@enduml
----
====
draw.io
A diagram drawn by hand on a canvas, for example the plan of the parish hall. Insert it with the blocks button of the editor and choose Draw.io: the editor opens the drawing tool and keeps the drawing inside the page. It uses the diagrams.net website unless the administrator sets up an own server.