diff --git a/source/_components/notify.telegram.markdown b/source/_components/notify.telegram.markdown
index ee90fb0297a..c9b621625e9 100644
--- a/source/_components/notify.telegram.markdown
+++ b/source/_components/notify.telegram.markdown
@@ -60,18 +60,15 @@ notify:
 
 Configuration variables:
 
-- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service
-`notify.NOTIFIER_NAME`.
+- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
 - **api_key** (*Required*): The API token of your bot.
 - **chat_id** (*Required*: The chat ID of your user.
 
 To use notifications, please see the [getting started with automation page](/getting-started/automation/).
 
-### Photo support
+### {% linkable_title Photo support %}
 
 ```yaml
-...
-
 action:
   service: notify.NOTIFIER_NAME
   data:
@@ -88,6 +85,8 @@ action:
           caption: I.e. for a Title
 ```
 
-- **url** or **file** (*Required*): For local or remote path to a picture
-- **caption** (*Optional*: Picture title
-- **username** and **password** (*Optional*: For URL they require a basic auth
+- **url** or **file** (*Required*): For local or remote path to an image.
+- **caption** (*Optional*): The title of the image.
+- **username** (*Optional*): Username for an URL which require HTTP basic authentication.
+- **password** (*Optional*): Username for an URL which require HTTP basic authentication.
+