diff --git a/packages/docs/src/content/docs/guides/troubleshooting.md b/packages/docs/src/content/docs/guides/troubleshooting.md
index 63152a982..92cce3c65 100644
--- a/packages/docs/src/content/docs/guides/troubleshooting.md
+++ b/packages/docs/src/content/docs/guides/troubleshooting.md
@@ -14,8 +14,12 @@ We can distinguish two types of issues:
 This indicates a successful run, but there are unused items. Continue with
 [handling issues][3] to deal with unused items reported by Knip.
 
+:::tip
+
 Use [--debug][4] and [--trace][5] to troubleshoot issues.
 
+:::
+
 ## Exceptions thrown by Knip
 
 Knip (or one of its plugins loading a configuration file) may throw an error,