diff --git a/source/_components/switch.switchbot.markdown b/source/_components/switch.switchbot.markdown
index a87273de79c..617a9378220 100644
--- a/source/_components/switch.switchbot.markdown
+++ b/source/_components/switch.switchbot.markdown
@@ -13,19 +13,21 @@ ha_release: 0.78
 ha_iot_class: "Local Polling"
 ---
 
-This `Switchbot` switch platform allows you to control Switchbot [devices]( https://www.switch-bot.com/).
+The `switchbot` switch platform allows you to control Switchbot [devices](https://www.switch-bot.com/).
+
+## {% linkable_title Manual Configuration %}
 
 To enable it, add the following lines to your `configuration.yaml`:
 
 ```yaml
 switch:
   - platform: switchbot
-    mac: 'cb:25:0b......'
+    mac: 'MAC_ADDRESS'
 ```
 
 {% configuration %}
 mac:
-  description: Device MAC address.
+  description: The device MAC address with lower-case letters.
   required: true
   type: string
 name: