diff --git a/docs/backend-system/core-services/actions.md b/docs/backend-system/core-services/actions.md
index a82bb6955c..0122bf2649 100644
--- a/docs/backend-system/core-services/actions.md
+++ b/docs/backend-system/core-services/actions.md
@@ -30,7 +30,9 @@ This naming convention ensures that action names are globally unique across all
 
 ## Configuration
 
-The Actions Service can be configured to control which plugins' actions are available:
+### Restricting action sources by plugin
+
+The `pluginSources` configuration limits which plugins are allowed to register actions.
 
 ```yaml
 backend:
@@ -39,15 +41,6 @@ backend:
       - catalog
 ```
 
-### Restricting action sources by plugin
-
-The `pluginSources` configuration limits which plugins are allowed to register actions.
-
-````yaml
-backend:
-  actions:
-    pluginSources:
-      - catalog
 ### Filtering actions
 
 In addition to plugin-level restrictions, the Actions Service supports filtering actions using include and exclude rules. This allows fine-grained control over which actions are exposed or runnable in a Backstage instance.
@@ -60,12 +53,17 @@ backend:
     filter:
       include:
         - 'catalog.*'
-#### Exclude specific actions
+```
+
+#### Exclude specific actionspwd
+
+```yaml
 backend:
   actions:
     filter:
       exclude:
         - 'scaffolder.internal.*'
+```
 
 ## Using the Service
 
@@ -103,7 +101,7 @@ export async function listAvailableActions(
     throw error;
   }
 }
-````
+```
 
 ### Invoking an Action