diff --git a/docs/integrations/azure/discovery.md b/docs/integrations/azure/discovery.md
index e64bf42636..99feb9a806 100644
--- a/docs/integrations/azure/discovery.md
+++ b/docs/integrations/azure/discovery.md
@@ -85,7 +85,7 @@ The parameters available are:
   - **`scope`** _(optional)_:
     `'global'` or `'local'`. Sets the scope of concurrency control.
 
-_Note:_
+:::note Note
 
 - The path parameter follows the same rules as the search on Azure DevOps web interface. For more details visit the [official search documentation](https://docs.microsoft.com/en-us/azure/devops/project/search/get-started-search?view=azure-devops).
 - To use branch parameters, it is necessary that the desired branch be added to the "Searchable branches" list within Azure DevOps Repositories. To do this, follow the instructions below:
@@ -97,6 +97,8 @@ _Note:_
 5. In the window that appears, enter the name of the branch you want to add and click "Add".
 6. The added branch will now appear in the "Searchable branches" list.
 
+:::
+
 It may take some time before the branch is indexed and searchable.
 
 As this provider is not one of the default providers, you will first need to install
diff --git a/docs/integrations/bitbucketCloud/discovery.md b/docs/integrations/bitbucketCloud/discovery.md
index b000a45ccd..ff0e60f498 100644
--- a/docs/integrations/bitbucketCloud/discovery.md
+++ b/docs/integrations/bitbucketCloud/discovery.md
@@ -121,9 +121,14 @@ catalog:
         workspace: workspace-name
 ```
 
-> **Note:** It is possible but certainly not recommended to skip the provider ID level.
+:::note Note
+
+It is possible but certainly not recommended to skip the provider ID level.
+
 > If you do so, `default` will be used as provider ID.
 
+:::
+
 - **`catalogPath`** _(optional)_:
   Default: `/catalog-info.yaml`.
   Path where to look for `catalog-info.yaml` files.