diff --git a/docs/docs/installation.mdx b/docs/docs/installation.mdx
index ec9be527951c..2767ce23fd78 100644
--- a/docs/docs/installation.mdx
+++ b/docs/docs/installation.mdx
@@ -12,8 +12,10 @@ import TabItem from "@theme/TabItem";
 Oh my Posh uses ANSI color codes under the hood, these should work everywhere,
 but you may have to set `$TERM` to `xterm-256color` for it to work.
 
-For maximum enjoyment, make sure to install a powerline enabled font. The fonts I use are patched by [Nerd Fonts][nerdfonts],
-which offers a maximum of icons you can use to configure your prompt.
+:::caution Font icons
+For maximum enjoyment, make sure to **install** and **configure** your terminal to use a powerline enabled font.
+The fonts we use are patched by [Nerd Fonts][nerdfonts], which offer a maximum of icons you can use to configure your prompt.
+:::
 
 Oh my Posh was designed using [Meslo LGM NF][meslo], so if you happen to see missing icons either change to that font or replace the icons
 by changing the [theme][themes] to your liking.
diff --git a/docs/docs/package-powershell.md b/docs/docs/package-powershell.mdx
similarity index 70%
rename from docs/docs/package-powershell.md
rename to docs/docs/package-powershell.mdx
index 3a4812125bbe..7aa82ac639ad 100644
--- a/docs/docs/package-powershell.md
+++ b/docs/docs/package-powershell.mdx
@@ -6,6 +6,11 @@ sidebar_label: PowerShell
 
 A package that includes useful helper functions to install and configure Oh my Posh.
 
+:::caution Font icons
+For maximum enjoyment, make sure to **install** and **configure** your terminal to use a powerline enabled font.
+The fonts we use are patched by [Nerd Fonts][nerdfonts], which offer a maximum of icons you can use to configure your prompt.
+:::
+
 ## Installation
 
 ```powershell
@@ -38,3 +43,5 @@ Useful when you find a theme you like, but you want to tweak the settings a bit.
 ```powershell
 Write-PoshTheme
 ```
+
+[nerdfonts]: https://www.nerdfonts.com/