diff --git a/aclk/README.md b/aclk/README.md
index 3e8c52aea7..4f46930254 100644
--- a/aclk/README.md
+++ b/aclk/README.md
@@ -9,13 +9,10 @@ The Cloud App lives at app.netdata.cloud which currently resolves to the followi
- 54.198.178.11
- 44.207.131.212
- 44.196.50.41
-
-:::caution
-This list of IPs can change without notice, we strongly advise you to whitelist following domains `api.netdata.cloud`, `mqtt.netdata.cloud`, if
-this is not an option in your case always verify the current domain resolution (e.g via the `host` command).
-
-:::
+> ### Caution
+>
+>This list of IPs can change without notice, we strongly advise you to whitelist following domains `api.netdata.cloud`, `mqtt.netdata.cloud`, if this is not an option in your case always verify the current domain resolution (e.g via the `host` command).
For a guide to connecting a node using the ACLK, plus additional troubleshooting and reference information, read our [connect to Cloud
documentation](https://github.com/netdata/netdata/blob/master/claim/README.md).
diff --git a/daemon/config/README.md b/daemon/config/README.md
index abaaf10c81..418b12cf9e 100644
--- a/daemon/config/README.md
+++ b/daemon/config/README.md
@@ -107,12 +107,9 @@ Please note that your data history will be lost if you have modified `history` p
| delete orphan hosts files | `yes` | Set to `no` to disable non-responsive host removal. |
| enable zero metrics | `no` | Set to `yes` to show charts when all their metrics are zero. |
-:::info
-
-The multiplication of all the **enabled** tiers `dbengine tier N update every iterations` values must be less than `65535`.
-
-:::
-
+> ### Info
+>
+>The multiplication of all the **enabled** tiers `dbengine tier N update every iterations` values must be less than `65535`.
### [directories] section options
diff --git a/docs/cloud/manage/plans.md b/docs/cloud/manage/plans.md
index 15ac19c679..9180ab5a0b 100644
--- a/docs/cloud/manage/plans.md
+++ b/docs/cloud/manage/plans.md
@@ -6,14 +6,12 @@ At Netdata, we believe in providing free and unrestricted access to high-quality
We also provide paid subscriptions that designed to provide additional features and capabilities for businesses that need tighter and customizable integration of the free monitoring solution to their processes. These are divided into three different plans: **Pro**, **Business**, and **Enterprise**. Each plan will offers a different set of features and capabilities to meet the needs of businesses of different sizes and with different monitoring requirements.
-:::note
-To not disrupt current users space's access rights we will be keeping their current plan as the **Early Bird** plan. The reason for this is to allow users to
-keep using the legacy **Member** role with the exact same permissions as it has currently.
-
-If you move from the **Early Bird** plan to a paid plan, you will not be able to return to the **Early Bird** plan again. The **Community** free plan will always be available to you, but it does not allow
-you to invite or change users using the Member role. See more details on our [roles and plans](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/role-based-access.md#what-roles-are-available) documentation.
-
-:::
+> ### Note
+> To not disrupt the existing space user's access rights we will keep them in the **Early Bird** plan. The reason for this is to allow users to
+> keep using the legacy **Member** role with the exact same permissions as it has currently.
+>
+> If you move from the **Early Bird** plan to a paid plan, you will not be able to return to the **Early Bird** plan again. The **Community** free plan will always be available to you, but it does not allow
+> you to invite or change users using the Member role. See more details on our [roles and plans](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/role-based-access.md#what-roles-are-available) documentation.
### Plans
diff --git a/docs/cloud/spaces.md b/docs/cloud/spaces.md
index c1db566baf..2a275c14ce 100644
--- a/docs/cloud/spaces.md
+++ b/docs/cloud/spaces.md
@@ -62,8 +62,9 @@ will open a side tab in which you can:
6. _Manage your bookmarks*_, click on the **Bookmarks** tab to add or remove bookmarks that you need.
-:::note \* This action requires admin rights for this space
-:::
+> ### Note
+>
+> \* This action requires admin rights for this space
## Obsoleting offline nodes from a Space
diff --git a/docs/cloud/visualize/interact-new-charts.md b/docs/cloud/visualize/interact-new-charts.md
index e6d86790f6..7db811e292 100644
--- a/docs/cloud/visualize/interact-new-charts.md
+++ b/docs/cloud/visualize/interact-new-charts.md
@@ -185,14 +185,10 @@ following:
* Trimmed Mean `*`
* Percentile `**`
-:::info
-
-- `*` For **Trimmed Median and Mean** you can choose the percentage of data tha you want to focus on: 1%, 2%, 3%, 5%,
- 10%, 15%, 20% and 25%.
-- `**` For **Percentile** you can specify the percentile you want to focus on: 25th, 50th, 75th, 80th, 90th, 95th, 97th,
- 98th and 99th.
-
-:::
+> ### Info
+>
+> - `*` For **Trimmed Median and Mean** you can choose the percentage of data tha you want to focus on: 1%, 2%, 3%, 5%, 10%, 15%, 20% and 25%.
+> - `**` For **Percentile** you can specify the percentile you want to focus on: 25th, 50th, 75th, 80th, 90th, 95th, 97th, 98th and 99th.
For more details on each, you can refer to our Agent's HTTP API details
on [Data Queries - Data Grouping](https://github.com/netdata/netdata/blob/master/web/api/queries/README.md#data-grouping).
diff --git a/docs/guides/troubleshoot/troubleshooting-agent-with-cloud-connection.md b/docs/guides/troubleshoot/troubleshooting-agent-with-cloud-connection.md
index 9583368e23..a0e8973f7a 100644
--- a/docs/guides/troubleshoot/troubleshooting-agent-with-cloud-connection.md
+++ b/docs/guides/troubleshoot/troubleshooting-agent-with-cloud-connection.md
@@ -48,12 +48,10 @@ and you must do it manually, using the following steps:
3. Retry the kickstart claiming process.
-:::note
-
-In some cases a simple restart of the Agent can fix the issue.
-Read more about [Starting, Stopping and Restarting the Agent](https://github.com/netdata/netdata/blob/master/docs/configure/start-stop-restart.md).
-
-:::
+> ### Note
+>
+> In some cases a simple restart of the Agent can fix the issue.
+> Read more about [Starting, Stopping and Restarting the Agent](https://github.com/netdata/netdata/blob/master/docs/configure/start-stop-restart.md).
## Claiming on an older, deprecated version of the Agent
@@ -109,9 +107,7 @@ To verify this:
main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com has address 44.196.50.41
```
- :::info
-
- There will be cases in which the firewall restricts network access. In those cases, you need to whitelist `api.netdata.cloud` and `mqtt.netdata.cloud` domains to be able to see your nodes in Netdata Cloud.
- If you can't whitelist domains in your firewall, you can whitelist the IPs that the above command will produce, but keep in mind that they can change without any notice.
-
- :::
+ > ### Info
+ >
+ > There will be cases in which the firewall restricts network access. In those cases, you need to whitelist `api.netdata.cloud` and `mqtt.netdata.cloud` domains to be able to see your nodes in Netdata Cloud.
+ > If you can't whitelist domains in your firewall, you can whitelist the IPs that the above command will produce, but keep in mind that they can change without any notice.
diff --git a/packaging/installer/README.md b/packaging/installer/README.md
index 402096119d..869684da36 100644
--- a/packaging/installer/README.md
+++ b/packaging/installer/README.md
@@ -87,12 +87,10 @@ To install, copy the script, paste it into your node's terminal, and hit `Enter`
</TabItem>
</Tabs>
-:::note
-If you plan to also claim the node to Netdata Cloud,
-make sure to replace `YOUR_CLAIM_TOKEN` with the claim token of your space,
-and `YOUR_ROOM_ID` with the ID of the room you are willing to claim to.
-You can leave the room id blank to have your node claimed to the default "All nodes" room.
-:::
+> ### Note
+>
+> If you plan to also claim the node to Netdata Cloud, make sure to replace `YOUR_CLAIM_TOKEN` with the claim token of your space, and `YOUR_ROOM_ID` with the ID of the room you are claiming to.
+> You can leave the room id blank to have your node claimed to the default "All nodes" room.
Jump down to [what's next](#whats-next) to learn how to view your new dashboard and take your next steps monitoring and
troubleshooting with Netdata.