diff --git a/source/_components/tts.marytts.markdown b/source/_components/tts.marytts.markdown
index 7b13da9906b..7edeba02469 100644
--- a/source/_components/tts.marytts.markdown
+++ b/source/_components/tts.marytts.markdown
@@ -14,27 +14,49 @@ ha_release: 0.43
 
 The `marytts` text-to-speech platform uses [MaryTTS](http://mary.dfki.de/) Text-to-Speech engine to read a text with natural sounding voices.
 
+## {% linkable_title Configuration %}
+
 To enable text-to-speech with MaryTTS, add the following lines to your `configuration.yaml`:
 
 ```yaml
 # Example configuration.yaml entry
 tts:
   - platform: marytts
-    host: 'localhost'
-    port: 59125
 ```
 
-Configuration variables:
-
-- **host** (*Optional*): MaryTTS server hostname or IP address. Default is `localhost`.
-- **port** (*Optional*): MaryTTS server port. Default is 59125.
-- **codec** (*Optional*): Audio codec. Default is `wav`. Supported are `aiff`, `au`, `wav`.
-- **voice** (*Optional*): Speaker voice. Default is `cmu-slt-hsmm`.
-- **language** (*Optional*): Language to use. Default is `en-US`. Supports 'de', 'en-GB', 'en-US', 'fr', 'it', 'lb', 'ru', 'sv', 'te', 'tr'.
+{% configuration %}
+host:
+  description: The MaryTTS server hostname or IP address.
+  required: false
+  type: string
+  default: localhost
+port:
+  description: The MaryTTS server port.
+  required: false
+  type: integer
+  default: 59125
+codec:
+  description: "The audio codec. Supported codecs are `aiff`, `au` and `wav`."
+  required: false
+  type: string
+  default: "`wav`"
+voice:
+  description: The speaker voice.
+  required: false
+  type: string
+  default: "`cmu-slt-hsmm`"
+language:
+  description: "The language to use. Supported languages are `de`, `en-GB`, `en-US`, `fr`, `it`, `lb`, `ru`, `sv`, `te` and `tr`."
+  required: false
+  type: string
+  default: "`en-US`"
+{% endconfiguration %}
 
 See [documentation](http://mary.dfki.de/documentation/index.html) for details.
 
-A full configuration sample:
+## {% linkable_title Full configuration example %}
+
+A full configuration sample including optional variables:
 
 ```yaml
 # Example configuration.yaml entry