diff --git a/core/lib/Drupal/Component/Utility/String.php b/core/lib/Drupal/Component/Utility/String.php
index 9796a5fc018344e5ac7531e81e05fae34f97a2fc..2a3ae58ed6709f8d446cb6e9250c56893fee5d76 100644
--- a/core/lib/Drupal/Component/Utility/String.php
+++ b/core/lib/Drupal/Component/Utility/String.php
@@ -74,7 +74,10 @@ public static function decodeEntities($text) {
    *   - @variable: Escaped to HTML using String::checkPlain(). Use this as the
    *     default choice for anything displayed on a page on the site.
    *   - %variable: Escaped to HTML and formatted using String::placeholder(),
-   *     which makes it display as <em>emphasized</em> text.
+   *     which makes the following HTML code:
+   *     @code
+   *       <em class="placeholder">text output here.</em>
+   *     @endcode
    *   - !variable: Inserted as is, with no sanitization or formatting. Only use
    *     this for text that has already been prepared for HTML display (for
    *     example, user-supplied text that has already been run through