diff --git a/README.md b/README.md
index c727682e..fc3bcc87 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,5 @@
 1. [API documentation](https://jeffersonlab.github.io/iguana/)
 1. [Repository Maintenance](doc/maintenance.md)
 
-**NOTE**: this is still a _prototype_ design
+> [!CAUTION]
+> This is still a _prototype_ design
diff --git a/doc/setup.md b/doc/setup.md
index fb6a2ce6..b2bd334f 100644
--- a/doc/setup.md
+++ b/doc/setup.md
@@ -63,5 +63,6 @@ Instead of `configure.py`, use `meson` directly for more control:
 meson setup --prefix=$(pwd)/iguana build-iguana /path/to/iguana/repository
 meson install -C build-iguana
 ```
-**NOTE**: `configure.py` produces a native file (`.ini`) which may be used by
-`meson setup` option `--native-file`.
+
+> [!TIP]
+> `configure.py` produces a native file (`.ini`) which may be used by `meson setup` option `--native-file`.