diff --git a/nixd/docs/configuration.md b/nixd/docs/configuration.md
index 0f265ec56..44d147bdb 100644
--- a/nixd/docs/configuration.md
+++ b/nixd/docs/configuration.md
@@ -112,7 +112,8 @@ nvim_lsp.nixd.setup({
 
 ### Configuration overview
 
-> Note: This annotated json are under the key "nixd". If you don't know what does exactly this mean please see editor examples above.
+> [!NOTE]
+> This annotated json are under the key "nixd". If you don't know what does exactly this mean please see editor examples above.
 
 ```jsonc
 {
diff --git a/nixd/docs/dev.md b/nixd/docs/dev.md
index 0612fb668..79c8f2f18 100644
--- a/nixd/docs/dev.md
+++ b/nixd/docs/dev.md
@@ -39,7 +39,8 @@ ninja -C build install
 
 Then you can lauch an editor to quick test nixd, under `local/install/bin`.
 
-> Note: `nixd` cannot be properly launched from "build" directory (i.e. it requires installation for editor testing).
+> [!WARNING]
+> `nixd` cannot be properly launched from "build" directory (i.e. it requires installation for editor testing).
 
 To run unit/regression test, invoke: