diff --git a/docs/styles/align.md b/docs/styles/align.md
index eccb0b637..41fb1b80f 100644
--- a/docs/styles/align.md
+++ b/docs/styles/align.md
@@ -3,18 +3,19 @@
 The `align` style aligns children within a container.
 Not to be confused with [`content-align`](../content_align).
 
-You can specify the alignment of children on both the horizontal and vertical axes at the same time,
-or on each of the axis separately.
-
 ## Syntax
 
 --8<-- "docs/snippets/syntax_block_start.md"
 align: <a href="../css_types/horizontal.md">&lt;horizontal&gt;</a> <a href="../css_types/vertical.md">&lt;vertical&gt;</a>;
+
 align-horizontal: <a href="../css_types/horizontal.md">&lt;horizontal&gt;</a>;
 align-vertical: <a href="../css_types/vertical.md">&lt;vertical&gt;</a>;
 --8<-- "docs/snippets/syntax_block_end.md"
 
 The style `align` takes a [`<horizontal>`](../css_types/horizontal.md) followed by a [`<vertical>`](../css_types/vertical.md).
+
+You can specify the alignment of children on both the horizontal and vertical axes at the same time,
+or on each of the axis separately.
 To specify alignment on a single axis, use the respective style and type:
 
  - `align-horizontal` takes a [`<horizontal>`](../css_types/horizontal.md) and does alignment along the horizontal axis; and
@@ -22,8 +23,12 @@ To specify alignment on a single axis, use the respective style and type:
 
 ### Values
 
+#### &lt;horizontal&gt;
+
 --8<-- "docs/snippets/type_syntax/horizontal.md"
 
+#### &lt;vertical&gt;
+
 --8<-- "docs/snippets/type_syntax/vertical.md"
 
 
diff --git a/docs/styles/background.md b/docs/styles/background.md
index 09a94f609..be2d7f867 100644
--- a/docs/styles/background.md
+++ b/docs/styles/background.md
@@ -12,8 +12,12 @@ The style `background` needs a [`<color>`](../css_types/color.md) followed by an
 
 ### Values
 
+#### &lt;color&gt;
+
 --8<-- "docs/snippets/type_syntax/color.md"
 
+#### &lt;percentage&gt;
+
 --8<-- "docs/snippets/type_syntax/percentage.md"
 This is clamped between `0%` and `100%`.