diff --git a/source/_docs/configuration/entity-registry.markdown b/source/_docs/configuration/entity-registry.markdown
index 2f29afc306c..b699bb979eb 100644
--- a/source/_docs/configuration/entity-registry.markdown
+++ b/source/_docs/configuration/entity-registry.markdown
@@ -9,24 +9,18 @@ sharing: true
 footer: true
 ---
 
-Starting with version 0.63, Home Assistant keeps a registry of known entities.
-The entity registry makes sure that entities get unique identifiers and allow
-customizing the identifiers and names of these entities.
+Starting with version 0.63, Home Assistant keeps a registry of known entities. The entity registry makes sure that entities get unique identifiers and allow customizing the identifiers and names of these entities.
 
-Changes require that Home Assistant is shut down when you edit the file, otherwise
-Home Assistant may over-write your changes, and a restart of Home Assistant is
-required for your changes to take effect. Version 0.75 introduced a configuration
-user interface.
+Changes require that Home Assistant is shut down when you edit the file, otherwise Home Assistant may over-write your changes, and a restart of Home Assistant is required for your changes to take effect. Version 0.75 introduced a configuration user interface.
 
 <p class='note'>
 An entity needs to have a unique ID to be registered in the entity registry.
 Not all integrations currently provide a unique id for their entities.
 </p>
 
-The entity registry is stored in `<config>/entity_registry.yaml`. As a user,
-you are unable to add entries, only update them. Here is an example file:
+The entity registry is stored in `<config>/entity_registry.yaml`. As a user, you are unable to add entries, only update them. Here is an example file:
 
-```
+```yaml
 climate.downstairs_virtual:
   platform: nest
   unique_id: EPoMyWkpNyoYu3pGlmGxabcdefghijkl
@@ -37,16 +31,13 @@ light.study_ceiling:
   disabled_by: user
 ```
 
-As a user, you can change the `entity_id` and add the `name` and `disabled_by`
-value to each entry.
- - Changing the _first line_ of each entry will change the `entity_id` of the entity throughout Home Assistant.
+As a user, you can change the `entity_id` and add the `name` and `disabled_by`value to each entry.
 
+ - Changing the _first line_ of each entry will change the `entity_id` of the entity throughout Home Assistant.
  - The value of `name` will override the _friendly name_ of the entity as given by the integration.
 
    _Added in Home Assistant 0.64._
- - The key `disabled_by` can either be `hass` or `user`. This functionality
-   is even more experimental than the whole entity registry itself and might
-   cause integrations to fail and might be removed in the future.
+ - The key `disabled_by` can either be `hass` or `user`. This functionality is even more experimental than the whole entity registry itself and might cause integrations to fail and might be removed in the future.
 
    _Added in Home Assistant 0.64._