diff --git a/tsdb/docs/format/chunks.md b/tsdb/docs/format/chunks.md
index 837db020e..d6e3a3ae6 100644
--- a/tsdb/docs/format/chunks.md
+++ b/tsdb/docs/format/chunks.md
@@ -48,7 +48,7 @@ Notes:
 └──────────────────────┴───────────────┴───────────────┴──────────────────────┴──────────────────────┴──────────────────────┴──────────────────────┴─────┴──────────────────────┴──────────────────────┴──────────────────┘
 ```
 
-### Notes
+### Notes:
 
 * `ts` is the timestamp, `v` is the value.
 * `...` means to repeat the previous two fields as needed, with `n` starting at 2 and going up to `num_samples` – 1.
@@ -73,7 +73,7 @@ Notes:
 └──────────────────────┴──────────────────────────┴───────────────────────────────┴─────────────────────┴──────────────────┴──────────────────┴──────────────────────┴────────────────┴──────────────────┘
 ```
 
-### Positive and negative spans data
+### Positive and negative spans data:
 
 ```
 ┌─────────────────────────┬────────────────────────┬───────────────────────┬────────────────────────┬───────────────────────┬─────┬────────────────────────┬───────────────────────┐
@@ -81,7 +81,7 @@ Notes:
 └─────────────────────────┴────────────────────────┴───────────────────────┴────────────────────────┴───────────────────────┴─────┴────────────────────────┴───────────────────────┘
 ```
 
-### Custom values data
+### Custom values data:
 
 The `custom_values` data is currently only used for schema -53 (custom bucket boundaries). For other schemas, it is empty (length of zero).
 
@@ -91,7 +91,7 @@ The `custom_values` data is currently only used for schema -53 (custom bucket bo
 └──────────────────────────┴─────────────────────────────────────┴─────┴──────────────────┘
 ```
 
-### Samples data
+### Samples data:
 
 ```
 ┌──────────────────────────┐
@@ -107,7 +107,7 @@ The `custom_values` data is currently only used for schema -53 (custom bucket bo
 └──────────────────────────┘
 ```
 
-#### Sample 0 data
+#### Sample 0 data:
 
 ```
 ┌─────────────────┬─────────────────────┬──────────────────────────┬───────────────┬───────────────────────────┬─────┬───────────────────────────┬───────────────────────────┬─────┬───────────────────────────┐
@@ -115,7 +115,7 @@ The `custom_values` data is currently only used for schema -53 (custom bucket bo
 └─────────────────┴─────────────────────┴──────────────────────────┴───────────────┴───────────────────────────┴─────┴───────────────────────────┴───────────────────────────┴─────┴───────────────────────────┘
 ```
 
-#### Sample 1 data
+#### Sample 1 data:
 
 ```
 ┌───────────────────────┬──────────────────────────┬───────────────────────────────┬──────────────────────┬─────────────────────────────────┬─────┬─────────────────────────────────┬─────────────────────────────────┬─────┬─────────────────────────────────┐
@@ -123,7 +123,7 @@ The `custom_values` data is currently only used for schema -53 (custom bucket bo
 └───────────────────────┴──────────────────────────┴───────────────────────────────┴──────────────────────┴─────────────────────────────────┴─────┴─────────────────────────────────┴─────────────────────────────────┴─────┴─────────────────────────────────┘
 ```
 
-#### Sample 2 data and following
+#### Sample 2 data and following:
 
 ```
 ┌─────────────────────┬────────────────────────┬─────────────────────────────┬──────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┐
@@ -131,7 +131,7 @@ The `custom_values` data is currently only used for schema -53 (custom bucket bo
 └─────────────────────┴────────────────────────┴─────────────────────────────┴──────────────────────┴───────────────────────────────┴─────┴───────────────────────────────┴───────────────────────────────┴─────┴───────────────────────────────┘
 ```
 
-### Notes
+### Notes:
 
 * `histogram_flags` is a byte of which currently only the first two bits are used:
   * `10`: Counter reset between the previous chunk and this one.
@@ -181,7 +181,7 @@ bound of 33554430 is picked so that the varbit encoded value will take at most
 
 Float histograms have the same layout as histograms apart from the encoding of samples.
 
-### Samples data
+### Samples data:
 
 ```
 ┌──────────────────────────┐
@@ -197,7 +197,7 @@ Float histograms have the same layout as histograms apart from the encoding of s
 └──────────────────────────┘
 ```
 
-#### Sample 0 data
+#### Sample 0 data:
 
 ```
 ┌─────────────────┬─────────────────┬──────────────────────┬───────────────┬────────────────────────┬─────┬────────────────────────┬────────────────────────┬─────┬────────────────────────┐
@@ -205,7 +205,7 @@ Float histograms have the same layout as histograms apart from the encoding of s
 └─────────────────┴─────────────────┴──────────────────────┴───────────────┴────────────────────────┴─────┴────────────────────────┴────────────────────────┴─────┴────────────────────────┘
 ```
 
-#### Sample 1 data
+#### Sample 1 data:
 
 ```
 ┌───────────────────────┬────────────────────────┬─────────────────────────────┬──────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┐
@@ -213,7 +213,7 @@ Float histograms have the same layout as histograms apart from the encoding of s
 └───────────────────────┴────────────────────────┴─────────────────────────────┴──────────────────────┴───────────────────────────────┴─────┴───────────────────────────────┴───────────────────────────────┴─────┴───────────────────────────────┘
 ```
 
-#### Sample 2 data and following
+#### Sample 2 data and following:
 
 ```
 ┌─────────────────────┬────────────────────────┬─────────────────────────────┬──────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┬───────────────────────────────┬─────┬───────────────────────────────┐