diff --git a/docs/gantt.md b/docs/gantt.md
index 4dafff1e9..0467d2b5f 100644
--- a/docs/gantt.md
+++ b/docs/gantt.md
@@ -133,7 +133,26 @@ To do so, start a line with the `section` keyword and give it a name. (Note that
 
 ### Milestones
 
-You can add milestones to the diagrams. Milestones differ from tasks as they represent a signle instant in time and are identifiedd by the keyword `milestone`
+You can add milestones to the diagrams. Milestones differ from tasks as they represent a signle instant in time and are identifiedd by the keyword `milestone`. Below is an example on how to use milestones. As you may notice, the exact location of the milestone is determined by the initial date for the milestone and the "duration" of the task this way: *initial date*+*duration*/2. 
+
+```
+gantt 
+dateFormat HH:mm
+axisFormat %H:%M
+Initial milestone : milestone, m1, 17:49,2min
+taska2 : 10min
+taska3 : 5min 
+Final milestone : milestone, m2, 18:14, 2min
+```
+```mermaid
+gantt 
+dateFormat HH:mm
+axisFormat %H:%M
+Initial milestone : milestone, m1, 17:49,2min
+taska2 : 10min
+taska3 : 5min 
+Final milestone : milestone, m2, 18:14, 2min
+```
 
 
 ## Setting dates