diff --git a/docs/installation.md b/docs/installation.md
index 11aeb04..8a585dc 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -97,20 +97,23 @@ This invokes the `meson` build system to compile the C sources via `f2py`
 and install the resulting extension module.
 
 !!! warning "C compiler required"
-    Source builds require a working C compiler.
-
-    ```bash
-    # Debian/Ubuntu
-    sudo apt install gcc
-
-    # Fedora
-    sudo dnf install gcc
-
-    # macOS (Clang via Xcode Command Line Tools)
-    xcode-select --install
-    ```
-
-    On Windows, install MSVC via Visual Studio Build Tools. MinGW is not supported.
+    Source builds require a working C compiler. On most Linux distributions,
+    install `gcc`:
+
+    === "Debian / Ubuntu"
+        ```bash
+        sudo apt install gcc
+        ```
+    === "Fedora"
+        ```bash
+        sudo dnf install gcc
+        ```
+    === "macOS (Homebrew)"
+        ```bash
+        brew install gcc
+        ```
+    === "Windows"
+        Install [MinGW-w64](https://www.mingw-w64.org/) with gcc or use MSYS2.
 
 ## Verifying the installation
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 9ea48ec..c14df4d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -17,21 +17,25 @@ theme:
     - content.code.copy
 
 markdown_extensions:
-  - admonition
+  - attr_list
+  - md_in_html
+  - pymdownx.blocks.caption
   - tables
-  - fenced_code
-  - pymdownx.superfences:
-      custom_fences:
-        - name: mermaid
-          class: mermaid
-          format: !!python/name:pymdownx.superfences.fence_code_format
-  - pymdownx.highlight
+  - toc:
+      permalink: true
+      title: Page contents
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.highlight:
+      pygments_lang_class: true
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
   - pymdownx.tabbed:
       alternate_style: true
   - pymdownx.arithmatex:
       generic: true
-  - toc:
-      permalink: true
 
 extra_javascript:
   - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js