add markdown toc stuff

4 files changed, 28 insertions, 8 deletions

diff --git a/docs/layout/flexbox.md b/docs/layout/flexbox.md
index e9087c766..05a407706 100644
--- a/docs/layout/flexbox.md
+++ b/docs/layout/flexbox.md
@@ -5,6 +5,11 @@ title: Flexbox
 
 Flexbox support has finally come to Bootstrap. Opt-in to the new CSS layout styles with the flick of a variable or the swap of a stylesheet.
 
+## Contents
+
+* Will be replaced with the ToC, excluding the "Contents" header
+{:toc}
+
 ## What's included
 
 Flexbox support is available for a number of Bootstrap's components:
diff --git a/docs/layout/grid.md b/docs/layout/grid.md
index 78ab7aed6..7415d33f7 100644
--- a/docs/layout/grid.md
+++ b/docs/layout/grid.md
@@ -7,6 +7,11 @@ Bootstrap includes a powerful mobile-first grid system for building layouts of a
 
 There are multiple tiers for different device sizes, available via our predefined classes or semantic mixins.
 
+## Contents
+
+* Will be replaced with the ToC, excluding the "Contents" header
+{:toc}
+
 ### Quick start
 
 - Example grid class
diff --git a/docs/layout/media.md b/docs/layout/media.md
index 5104895ec..8e3d9a613 100644
--- a/docs/layout/media.md
+++ b/docs/layout/media.md
@@ -5,7 +5,12 @@ title: Media
 
 Abstract object styles for building custom components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.
 
-### Default media
+## Contents
+
+* Will be replaced with the ToC, excluding the "Contents" header
+{:toc}
+
+## Default media
 
 The default media allow to float a media object (images, video, audio) to the left or right of a content block.
 
@@ -21,7 +26,7 @@ The default media allow to float a media object (images, video, audio) to the le
 </div>
 {% endexample %}
 
-### Nesting
+## Nesting
 
 Media components can also be nested.
 
@@ -48,7 +53,7 @@ Media components can also be nested.
 </div>
 {% endexample %}
 
-### Alignment
+## Alignment
 
 The images or other media can be aligned top, middle, or bottom. The default is top aligned.
 
@@ -97,7 +102,7 @@ The images or other media can be aligned top, middle, or bottom. The default is
 </div>
 {% endexample %}
 
-### Media list
+## Media list
 
 With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).
 
diff --git a/docs/layout/scaffolding.md b/docs/layout/scaffolding.md
index 7087b7deb..e20bc37a9 100644
--- a/docs/layout/scaffolding.md
+++ b/docs/layout/scaffolding.md
@@ -7,7 +7,12 @@ The scaffolding of Bootstrap refers to our general approach to building the proj
 
 Bootstrap's general approach to writing HTML, CSS, and JavaScript, as well as our core settings, is referred to as scaffolding. This includes required responsive and cross browser enhancements, dependencies, and more.
 
-### HTML5 doctype
+## Contents
+
+* Will be replaced with the ToC, excluding the "Contents" header
+{:toc}
+
+## HTML5 doctype
 
 Bootstrap makes use of certain HTML elements and CSS properties that **require** the use of the HTML5 doctype. Include it at the beginning of all your projects.
 
@@ -18,7 +23,7 @@ Bootstrap makes use of certain HTML elements and CSS properties that **require**
 </html>
 {% endhighlight %}
 
-### Mobile first
+## Mobile first
 
 Bootstrap is developed *mobile first*, a strategy in which we optimize code for mobile devices first and then scale up components as necessary using CSS media queries.
 
@@ -28,11 +33,11 @@ To ensure proper rendering and touch zooming, **add the viewport meta tag** to y
 <meta name="viewport" content="width=device-width, initial-scale=1">
 {% endhighlight %}
 
-### Normalize
+## Normalize
 
 For improved cross-browser rendering, we use [Normalize.css](http://necolas.github.io/normalize.css/) to correct small inconsistencies across browsers and devices.
 
-### Important CSS resets
+## Important CSS resets
 
 Still need to do this section. Should port the third party section about box sizing and edit it for here, then add the rest of the list items.