diff --git a/exampleSite/content/_index.md b/exampleSite/content/_index.md
index 4ae57d1..b59662a 100644
--- a/exampleSite/content/_index.md
+++ b/exampleSite/content/_index.md
@@ -1,5 +1,5 @@
 +++
-title = "Welcome to reveal-hugo!"
+title = "reveal-hugo features and usage"
 outputs = ["Reveal"]
 +++
 
diff --git a/exampleSite/content/home/shortcodes/fragment.md b/exampleSite/content/home/shortcodes/fragment.md
index 2702ca7..3d1b6bd 100644
--- a/exampleSite/content/home/shortcodes/fragment.md
+++ b/exampleSite/content/home/shortcodes/fragment.md
@@ -20,7 +20,7 @@ The `fragment` shortcode makes content appear incrementally.
 
 ## Frag shortcode
 
-The `frag` shortcode more terse than `fragment`. It accepts a `c` attribute.
+The `frag` shortcode is more terse than `fragment`. It accepts a `c` attribute.
 
 ```
 {{</* frag c="One" */>}}
diff --git a/exampleSite/content/home/shortcodes/markdown.md b/exampleSite/content/home/shortcodes/markdown.md
index c3f1000..4501928 100644
--- a/exampleSite/content/home/shortcodes/markdown.md
+++ b/exampleSite/content/home/shortcodes/markdown.md
@@ -14,7 +14,7 @@ This markdown is not processed by Hugo, but by Reveal.js itself.
 
 Many handy slide shortcuts and customizations are possible.
 
-[See them all](https://github.com/hakimel/reveal.js#markdown)
+[See the Reveal.js markdown docs](https://github.com/hakimel/reveal.js#markdown)
 
 ---
 
@@ -23,8 +23,12 @@ Many handy slide shortcuts and customizations are possible.
 For example, an HTML comment can change the background color of a slide.
 
 ```
+{{</* markdown */>}}
 <!-- .slide: data-background="blue" -->
+# I'm a blue slide
+{{</* /markdown */>}}
 ```
 
 {{< /markdown >}}
 
+---
diff --git a/exampleSite/content/home/shortcodes/slide.md b/exampleSite/content/home/shortcodes/slide.md
index 7843322..eced95b 100644
--- a/exampleSite/content/home/shortcodes/slide.md
+++ b/exampleSite/content/home/shortcodes/slide.md
@@ -4,18 +4,18 @@ weight = 34
 
 ## Slide shortcode
 
-Used to customize the parameters of individual slides like background color and transition.
+Customize individual slide parameters like background color and transition.
 
 [See all parameters](https://github.com/hakimel/reveal.js#slide-backgrounds)
 
 ---
 
-{{% slide transition="zoom" %}}
+{{% slide transition="zoom" transition-speed="fast" %}}
 
-## Custom slide 2
+## Custom slide 1
 
 ```
-{{%/* slide transition="zoom" */%}}
+{{%/* slide transition="zoom" transition-speed="fast" */%}}
 ## Custom slide 1
 {{%/* /slide */%}}
 ```
diff --git a/layouts/shortcodes/markdown.html b/layouts/shortcodes/markdown.html
index d0c40e5..f5effbc 100644
--- a/layouts/shortcodes/markdown.html
+++ b/layouts/shortcodes/markdown.html
@@ -1,4 +1,7 @@
-<section data-noprocess data-markdown data-separator="^\r?\n---\r?\n$">
+<section data-noprocess data-markdown
+  data-separator="^\r?\n---\r?\n$"
+  data-separator-vertical="^\r?\n------\r?\n$"
+  data-separator-notes="notes?:">
   <script type="text/template">
     {{ .Inner }}
   </script>
diff --git a/layouts/shortcodes/slide.html b/layouts/shortcodes/slide.html
index 6d35a32..6a4fc79 100644
--- a/layouts/shortcodes/slide.html
+++ b/layouts/shortcodes/slide.html
@@ -1,8 +1,8 @@
-{{ $attributes := slice "background-color" "background-image" "background-size" "background-position" "background-repeat" "transition" "background-iframe" "background-interactive" "background-video" "background-video-loop" "background-video-muted" "background-size" }}
+{{ $attributes := slice "background-color" "background-image" "background-size" "background-position" "background-repeat" "transition" "transition-speed" "background-iframe" "background-interactive" "background-video" "background-video-loop" "background-video-muted" }}
 {{ $params := . }}
 <section data-noprocess
-  {{ range $attribute := $attributes -}}
-    {{- with $params.Get $attribute }}data-{{ $attribute | safeHTMLAttr }}="{{ . }}"{{ end -}}
+  {{- range $attribute := $attributes -}}
+    {{- with $params.Get $attribute }} data-{{ $attribute | safeHTMLAttr }}="{{ . }}"{{ end -}}
   {{- end -}}
   >
 {{ .Inner }}