diff --git a/docs/4.0/content/tables.md b/docs/4.0/content/tables.md
index 515b9b19b1..59bdb6373c 100644
--- a/docs/4.0/content/tables.md
+++ b/docs/4.0/content/tables.md
@@ -16,10 +16,10 @@ Using the most basic table markup, here's how `.table`-based tables look in Boot
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -51,10 +51,10 @@ You can also invert the colors—with light text on dark backgrounds—with `.ta
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -88,10 +88,10 @@ Similar to tables and dark tables, use the modifier classes `.thead-light` or `.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -119,10 +119,10 @@ Similar to tables and dark tables, use the modifier classes `.thead-light` or `.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -156,10 +156,10 @@ Use `.table-striped` to add zebra-striping to any table row within the ``
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -189,10 +189,10 @@ Use `.table-striped` to add zebra-striping to any table row within the ``
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -226,10 +226,10 @@ Add `.table-bordered` for borders on all sides of the table and cells.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -264,10 +264,10 @@ Add `.table-bordered` for borders on all sides of the table and cells.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -306,10 +306,10 @@ Add `.table-hover` to enable a hover state on table rows within a ``.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -338,10 +338,10 @@ Add `.table-hover` to enable a hover state on table rows within a ``.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -374,10 +374,10 @@ Add `.table-sm` to make tables more compact by cutting cell padding in half.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -406,10 +406,10 @@ Add `.table-sm` to make tables more compact by cutting cell padding in half.
- # |
- First Name |
- Last Name |
- Username |
+ # |
+ First Name |
+ Last Name |
+ Username |
@@ -442,10 +442,10 @@ Use contextual classes to color table rows or individual cells.
- Type |
- Column heading |
- Column heading |
- Column heading |
+ Type |
+ Column heading |
+ Column heading |
+ Column heading |
@@ -493,10 +493,10 @@ Regular table background variants are not available with the dark table, however
- # |
- Column heading |
- Column heading |
- Column heading |
+ # |
+ Column heading |
+ Column heading |
+ Column heading |
@@ -595,16 +595,16 @@ Responsive tables make use of `overflow-y: hidden`, which clips off any content
- # |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
+ # |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
@@ -650,13 +650,13 @@ Responsive tables make use of `overflow-y: hidden`, which clips off any content
- # |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
- Table heading |
+ # |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
+ Table heading |
@@ -696,3 +696,42 @@ Responsive tables make use of `overflow-y: hidden`, which clips off any content
...
{% endhighlight %}
+
+
+## Captions
+
+A `` functions like a heading for a table. It helps users with screen readers to find a table and understand what it’s about and decide if they want to read it.
+
+{% example html %}
+
+ List of users
+
+
+ # |
+ First Name |
+ Last Name |
+ Username |
+
+
+
+
+ 1 |
+ Mark |
+ Otto |
+ @mdo |
+
+
+ 2 |
+ Jacob |
+ Thornton |
+ @fat |
+
+
+ 3 |
+ Larry |
+ the Bird |
+ @twitter |
+
+
+
+{% endexample %}