diff --git a/README.md b/README.md
index 53c0a01..20c139b 100755
--- a/README.md
+++ b/README.md
@@ -311,6 +311,16 @@ to something similar to "http://domain/#channel/2011-03-09 14:25:09", or
 
     When using Nexmo, this value is where the SMS is "from". In most cases, you must use a valid number in international format.
 
+*   `message_escape` Default: ` `
+
+    If set, keyword values will be escaped in this format before they are expanded in
+    `message_content`. Possible values are all that ZNC supports, most useful here will be
+    `HTML` or `URL`.
+
+    Note that the resulting string in `message_content` after keyword expansion will not be
+    escaped. If you need to escape characters for a service, you have to set the escaped
+    string to `message_content`.
+
 *   `message_uri` Default: ` `
 
     URI that will be sent with the push notification.  This could be a web address or a
diff --git a/doc/telegram.md b/doc/telegram.md
index 5794a1a..8f63aa9 100644
--- a/doc/telegram.md
+++ b/doc/telegram.md
@@ -16,5 +16,12 @@ module by following the above steps.
 * set secret to the **api key**: <code>/msg *push set secret your-api-key</code>
 * set target to chat ID: <code>/msg *push set target your-chat-id</code>
 
+You can style your messages with [basic HTML][HTML] when you set the
+`message_escape` option accordingly.
+
+    set message_escape HTML
+    set message_content <i>{context}</i>: &lt;<b>{nick}</b>&gt; {message}
+
 [Telegram]: https://telegram.org
 [BotFather]: https://core.telegram.org/bots#6-botfather
+[HTML]: https://core.telegram.org/bots/api#formatting-options