docs on 2-d presentations
diff --git a/README.Rmd b/README.Rmd
index c81e253..b387054 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -143,6 +143,22 @@
     
 Backgrounds transition using a fade animation by default. This can be changed to a linear sliding transition by specifying the `background-transition: slide`. Alternatively you can set data-background-transition on any slide with a background to override that specific transition.
 
+## 2-D Presenations
+
+You can use the `slide_level` option to specify which level of heading will be used to denote individual slides. If `slide_level` is 2 (the default), a two-dimensional layout will be produced, with level 1 headers building horizontally and level 2 headers building vertically. For example:
+
+    # Horizontal Slide 1
+    
+    ## Vertical Slide 1
+    
+    ## Vertical Slide 2
+    
+    # Horizontal Slide 2
+
+With this layout horizontal navigation will proceed directly from "Horizontal Slide 1" to "Horizontal Slide 2", with vertical navigation to "Vertical Slide 1", etc. presented as an option on "Horizontal Slide 1".
+
+
+
 ## Reveal.js Options
 
 Reveal.js has many additional options to conigure it's behavior. You can specify any of these options using `reveal_options`, for example:
diff --git a/README.md b/README.md
index dd59720..9ec23a5 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@
 -   [Appearance and Style](#appearance-and-style)
 -   [Slide Transitions](#slide-transitions)
 -   [Slide Backgrounds](#slide-backgrounds)
+-   [2-D Presenations](#d-presenations)
 -   [Reveal.js Options](#reveal.js-options)
 -   [Figure Options](#figure-options)
 -   [MathJax Equations](#mathjax-equations)
@@ -152,6 +153,21 @@
 
 Backgrounds transition using a fade animation by default. This can be changed to a linear sliding transition by specifying the `background-transition: slide`. Alternatively you can set data-background-transition on any slide with a background to override that specific transition.
 
+2-D Presenations
+----------------
+
+You can use the `slide_level` option to specify which level of heading will be used to denote individual slides. If `slide_level` is 2 (the default), a two-dimensional layout will be produced, with level 1 headers building horizontally and level 2 headers building vertically. For example:
+
+    # Horizontal Slide 1
+
+    ## Vertical Slide 1
+
+    ## Vertical Slide 2
+
+    # Horizontal Slide 2
+
+With this layout horizontal navigation will proceed directly from "Horizontal Slide 1" to "Horizontal Slide 2", with vertical navigation to "Vertical Slide 1", etc. presented as an option on "Horizontal Slide 1".
+
 Reveal.js Options
 -----------------