diff --git a/docs/ldml/tr35-keyboards.md b/docs/ldml/tr35-keyboards.md
index 631c139b9c7..b3b4db988c3 100644
--- a/docs/ldml/tr35-keyboards.md
+++ b/docs/ldml/tr35-keyboards.md
@@ -1072,6 +1072,7 @@ _Attribute:_ `output` (optional)
> Specifies the character or character sequence from the `keys/key` element that is to have a special display.
> This attribute may be escaped with `\u` notation, see [Escaping](#Escaping).
> The `output` attribute may also contain the `\m{…}` syntax to reference a marker. See [Markers](#markers). Implementations may highlight a displayed marker, such as with a lighter text color, or a yellow highlight.
+> String variables may be substituted. See [String variables](#element-string)
_Attribute:_ `id` (optional)
@@ -1083,6 +1084,8 @@ _Attribute:_ `display` (required)
> Required and specifies the character sequence that should be displayed on the keytop for any key that generates the `@output` sequence or has the `@id`. (It is an error if the value of the `display` attribute is the same as the value of the `output` attribute, this would be an extraneous entry.)
+> String variables may be substituted. See [String variables](#element-string)
+
This attribute may be escaped with `\u` notation, see [Escaping](#Escaping).
**Example**
@@ -1470,6 +1473,7 @@ _Attribute:_ `value` (required)
+
@@ -1487,7 +1491,7 @@ These may be then used in multiple contexts:
…
-
+
```
* * *