Add vertical-align utilities

- Adds six new utils for vertical-align property
- Documents the additional classes in the utils docs

2 files changed, 34 insertions, 0 deletions

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index 9e3e55367..f89a136f8 100644
--- a/docs/_data/nav.yml
+++ b/docs/_data/nav.yml
@@ -66,6 +66,7 @@
     - title: Sizing and positioning
     - title: Spacing
     - title: Typography
+    - title: Vertical align
 
 # - title: Extend
 #   pages:
diff --git a/docs/utilities/vertical-align.md b/docs/utilities/vertical-align.md
new file mode 100644
index 000000000..8e03e58a6
--- /dev/null
+++ b/docs/utilities/vertical-align.md
@@ -0,0 +1,33 @@
+---
+layout: docs
+title: Vertical alignment
+group: utilities
+---
+
+Change the alignment of elements with the [`vertical-alignment`](https://developer.mozilla.org/en-US/docs/Web/CSS/vertical-align) utilities. Please note that vertical-align only affects inline, inline-block, inline-table, and table cell elements.
+
+Choose from  `.align-baseline`, `.align-top`, `.align-middle`, `.align-bottom`, `.align-text-bottom`, and `.align-text-top` as needed.
+
+With inline elements:
+
+{% example html %}
+<span class="align-baseline">baseline</span>
+<span class="align-top">top</span>
+<span class="align-middle">middle</span>
+<span class="align-bottom">bottom</span>
+<span class="align-text-top">text-top</span>
+<span class="align-text-bottom">text-bottom</span>
+{% endexample %}
+
+With table cells:
+
+{% example html %}
+<table style="height: 100px;">
+  <td class="align-baseline">baseline</td>
+  <td class="align-top">top</td>
+  <td class="align-middle">middle</td>
+  <td class="align-bottom">bottom</td>
+  <td class="align-text-top">text-top</td>
+  <td class="align-text-bottom">text-bottom</td>
+</table>
+{% endexample %}