diff --git a/content/article/markdown-formatting.md b/content/article/markdown-formatting.md
index 6b98356..2159045 100644
--- a/content/article/markdown-formatting.md
+++ b/content/article/markdown-formatting.md
@@ -338,8 +338,7 @@ Hugo can embed a range of different media via shortcodes (see [Hugo shortcodes](
 
 ---
 
-YouTube, and Vimeo videos can be easily embedded using video ids (the last bit of their URLs). Embedded content should contain a caption including... 
-
+YouTube, and Vimeo videos can be easily embedded using video ids (the last bit of their URLs).  Examples: 
 
 {{< youtube UEoDJ1v6U6U >}}
 <figcaption>Video 1: Video caption.</figcaption>
@@ -347,23 +346,24 @@ YouTube, and Vimeo videos can be easily embedded using video ids (the last bit o
 {{< vimeo 55073825 >}}
 <figcaption>Video 2: Video caption.</figcaption>
 
-Formatting (replace square brackets with curly brackets): 
+Formatting (*note: remove \* characters*): 
 ```
-[[< youtube UEoDJ1v6U6U >]]
+{{*< youtube UEoDJ1v6U6U >*}}
 <figcaption>Video 1: Video caption.</figcaption>
 
-[[< vimeo 55073825 >]]
+{{*< vimeo 55073825 >*}}
 <figcaption>Video 2: Video caption.</figcaption>
 ```
 
 ### GitHub Gists
 
+Example: 
 {{< gist  cmiltiadis 0c458dcea8b8569398f5988b0151636c   >}}
 <figcaption>Codegist 1: Gist caption.</figcaption>
 
-Formatting (replace square brackets with curly brackets): 
+Formatting (*note: remove \* characters*): 
 ```
-[[< gist username gistId >]]
+{{*< gist username gistId >*}}
 <figcaption>Codegist 1: Gist caption.</figcaption>
 ```