diff --git a/docs/styles/height.md b/docs/styles/height.md
index 5183bcbbf..b198ebecb 100644
--- a/docs/styles/height.md
+++ b/docs/styles/height.md
@@ -1,12 +1,17 @@
 # Height
 
-The `height` rule sets a widget's height. By default, it sets the height of the content area, but if `box-sizing` is set to `border-box` it sets the height of the border area.
+The `height` rule sets a widget's height.
 
 ## Syntax
 
-```
-height: <SCALAR>;
-```
+--8<-- "docs/snippets/syntax_block_start.md"
+height: <a href="../css_types/scalar.md">&lt;scalar&gt;</a>;
+--8<-- "docs/snippets/syntax_block_end.md"
+
+The style `height` needs a [`<scalar>`](../css_types/scalar.md) to determine the vertical length of the widget.
+By default, it sets the height of the content area, but if [`box-sizing`](./box_sizing) is set to `border-box` it sets the height of the border area.
+
+### Values
 
 --8<-- "docs/snippets/type_syntax/scalar.md"