diff --git a/polymer-layout/polymer-layout.html b/polymer-layout/polymer-layout.html
index b9d3aac..0a8acf6 100644
--- a/polymer-layout/polymer-layout.html
+++ b/polymer-layout/polymer-layout.html
@@ -8,13 +8,13 @@
  * @module Polymer Elements
  */
 /**
- * <polymer-layout> arranges nodes horizontally via absolution positioning.
+ * `<polymer-layout>` arranges nodes horizontally via absolution positioning.
  * Set the `vertical` attribute (boolean) to arrange vertically instead.
  * 
  * One arranged node may be marked as elastic by giving it a `flex`
  * attribute (boolean).
  
- * <polymer-layout> arranges it's sibling elements, not
+ * `<polymer-layout>` arranges it's sibling elements, not
  * it's children.
  *
  * Padding on the parent node is ignored.
@@ -37,13 +37,13 @@
  *      |--------------------------------------------------|
  *      ----------------------------------------------------
  *
- *  If body has width 52 device pixels (in this case, ascii characters), call that 52px.
- *  Column One has it's natural width of 12px (including border), Column Three has it's
- *  natural width of 14px, body border uses 2px, and Column Two automatically uses the
- *  remaining space: 24px.
+ * If body has width 52 device pixels (in this case, ascii characters), call that 52px.
+ * Column One has it's natural width of 12px (including border), Column Three has it's
+ * natural width of 14px, body border uses 2px, and Column Two automatically uses the
+ * remaining space: 24px.
  *
- *  As the parent node resizes, the elastic column reacts via CSS to adjust it's size.
- *  No javascript is used so the performance is generally ideal.
+ * As the parent node resizes, the elastic column reacts via CSS to adjust it's size.
+ * No javascript is used so the performance is generally ideal.
  *
  *      --------------------------------------------------------------------------
  *      |------------------------------------------------------------------------|
@@ -57,9 +57,9 @@
  *      |--------------------------------------|
  *      ----------------------------------------
  *
- *  Arrange in rows by adding the `vertical` attribute.
+ * Arrange in rows by adding the `vertical` attribute.
  *
- *  Example:
+ * Example:
  *
  *     // arrange divs into rows
  *
@@ -68,21 +68,21 @@
  *     <div flex>Row Two</div>
  *     <div>Row Three</div>
  *
- *  -------------                 -------------
- *  ||---------||                 ||---------||
- *  ||Row One  ||                 ||Row One  ||
- *  ||---------||                 ||---------||
- *  ||Row Two  ||                 ||Row Two  ||
- *  ||---------||                 ||         ||
- *  ||Row Three||                 ||         ||
- *  ||---------||                 ||         ||
- *  -------------                 ||         ||
- *                                ||         ||
- *                                ||         ||
- *                                ||---------||
- *                                ||Row Three||
- *                                ||---------||
- *                                -------------
+ *     -------------                 -------------
+ *     ||---------||                 ||---------||
+ *     ||Row One  ||                 ||Row One  ||
+ *     ||---------||                 ||---------||
+ *     ||Row Two  ||                 ||Row Two  ||
+ *     ||---------||                 ||         ||
+ *     ||Row Three||                 ||         ||
+ *     ||---------||                 ||         ||
+ *     -------------                 ||         ||
+ *                                   ||         ||
+ *                                   ||         ||
+ *                                   ||---------||
+ *                                   ||Row Three||
+ *                                   ||---------||
+ *                                   -------------
  *
  * Layouts can be nested arbitrarily.
  *
@@ -96,20 +96,19 @@
  *      <div>Footer</div>
  *     </div>
  *
- *  --------------------------------
- *  |-----------------------------||
- *  ||Menu     ||Title            ||
- *  ||         ||-----------------||
- *  ||         ||Toolbar          ||
- *  ||         ||-----------------||
- *  ||         ||Main             ||
- *  ||         ||                 ||
- *  ||         ||                 ||
- *  ||         ||-----------------||
- *  ||         ||Footer           ||
- *  ||         ||-----------------||
- *  --------------------------------
- *
+ *     --------------------------------
+ *     |-----------------------------||
+ *     ||Menu     ||Title            ||
+ *     ||         ||-----------------||
+ *     ||         ||Toolbar          ||
+ *     ||         ||-----------------||
+ *     ||         ||Main             ||
+ *     ||         ||                 ||
+ *     ||         ||                 ||
+ *     ||         ||-----------------||
+ *     ||         ||Footer           ||
+ *     ||         ||-----------------||
+ *     --------------------------------
  *
  * @class polymer-layout
  *