diff --git a/docs/reference/cli/pixi.md b/docs/reference/cli/pixi.md
index 12bacefe94..c36b3db414 100644
--- a/docs/reference/cli/pixi.md
+++ b/docs/reference/cli/pixi.md
@@ -1,7 +1,7 @@
 <!--- This file is autogenerated. Do not edit manually! -->
 # <code>pixi</code>
 
---8<-- "docs/reference/cli/pixi_extender.md:description"
+--8<-- "docs/reference/cli/pixi_extender:description"
 
 ## Usage
 ```
@@ -56,4 +56,4 @@ pixi [OPTIONS] <COMMAND>
 <br>**env**: `PIXI_NO_PROGRESS`
 <br>**default**: `false`
 
---8<-- "docs/reference/cli/pixi_extender.md:example"
+--8<-- "docs/reference/cli/pixi_extender:example"
diff --git a/docs/reference/cli/pixi/add.md b/docs/reference/cli/pixi/add.md
index 5fe7f7c65a..6086871f74 100644
--- a/docs/reference/cli/pixi/add.md
+++ b/docs/reference/cli/pixi/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds dependencies to the workspace
 
---8<-- "docs/reference/cli/pixi/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/add_extender:description"
 
 ## Usage
 ```
@@ -132,4 +132,4 @@ the minor version by default:
 Python, Rust, Julia, GCC, GXX, GFortran, NodeJS, Deno, R, R-Base, Perl
 
 
---8<-- "docs/reference/cli/pixi/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/add_extender:example"
diff --git a/docs/reference/cli/pixi/add_extender.md b/docs/reference/cli/pixi/add_extender
similarity index 100%
rename from docs/reference/cli/pixi/add_extender.md
rename to docs/reference/cli/pixi/add_extender
diff --git a/docs/reference/cli/pixi/auth.md b/docs/reference/cli/pixi/auth.md
index 25ce97c504..5ee534b898 100644
--- a/docs/reference/cli/pixi/auth.md
+++ b/docs/reference/cli/pixi/auth.md
@@ -4,7 +4,7 @@
 ## About
 Login to prefix.dev or anaconda.org servers to access private channels
 
---8<-- "docs/reference/cli/pixi/auth_extender.md:description"
+--8<-- "docs/reference/cli/pixi/auth_extender:description"
 
 ## Usage
 ```
@@ -18,4 +18,4 @@ pixi auth <COMMAND>
 | [`logout`](auth/logout.md) | Remove authentication information for a given host |
 
 
---8<-- "docs/reference/cli/pixi/auth_extender.md:example"
+--8<-- "docs/reference/cli/pixi/auth_extender:example"
diff --git a/docs/reference/cli/pixi/auth/login.md b/docs/reference/cli/pixi/auth/login.md
index d7a6c9106c..d743e6c3a3 100644
--- a/docs/reference/cli/pixi/auth/login.md
+++ b/docs/reference/cli/pixi/auth/login.md
@@ -4,7 +4,7 @@
 ## About
 Store authentication information for a given host
 
---8<-- "docs/reference/cli/pixi/auth/login_extender.md:description"
+--8<-- "docs/reference/cli/pixi/auth/login_extender:description"
 
 ## Usage
 ```
@@ -32,4 +32,4 @@ pixi auth login [OPTIONS] <HOST>
 - <a id="arg---s3-session-token" href="#arg---s3-session-token">`--s3-session-token <S3_SESSION_TOKEN>`</a>
 :  The S3 session token
 
---8<-- "docs/reference/cli/pixi/auth/login_extender.md:example"
+--8<-- "docs/reference/cli/pixi/auth/login_extender:example"
diff --git a/docs/reference/cli/pixi/auth/login_extender.md b/docs/reference/cli/pixi/auth/login_extender
similarity index 100%
rename from docs/reference/cli/pixi/auth/login_extender.md
rename to docs/reference/cli/pixi/auth/login_extender
diff --git a/docs/reference/cli/pixi/auth/logout.md b/docs/reference/cli/pixi/auth/logout.md
index 566ddb3928..cb4b1a117a 100644
--- a/docs/reference/cli/pixi/auth/logout.md
+++ b/docs/reference/cli/pixi/auth/logout.md
@@ -4,7 +4,7 @@
 ## About
 Remove authentication information for a given host
 
---8<-- "docs/reference/cli/pixi/auth/logout_extender.md:description"
+--8<-- "docs/reference/cli/pixi/auth/logout_extender:description"
 
 ## Usage
 ```
@@ -16,4 +16,4 @@ pixi auth logout <HOST>
 :  The host to remove authentication for
 <br>**required**: `true`
 
---8<-- "docs/reference/cli/pixi/auth/logout_extender.md:example"
+--8<-- "docs/reference/cli/pixi/auth/logout_extender:example"
diff --git a/docs/reference/cli/pixi/auth/logout_extender.md b/docs/reference/cli/pixi/auth/logout_extender
similarity index 100%
rename from docs/reference/cli/pixi/auth/logout_extender.md
rename to docs/reference/cli/pixi/auth/logout_extender
diff --git a/docs/reference/cli/pixi/build.md b/docs/reference/cli/pixi/build.md
index 477d7712af..eb6b6f1c37 100644
--- a/docs/reference/cli/pixi/build.md
+++ b/docs/reference/cli/pixi/build.md
@@ -4,7 +4,7 @@
 ## About
 Workspace configuration
 
---8<-- "docs/reference/cli/pixi/build_extender.md:description"
+--8<-- "docs/reference/cli/pixi/build_extender:description"
 
 ## Usage
 ```
@@ -40,4 +40,4 @@ pixi build [OPTIONS]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/build_extender.md:example"
+--8<-- "docs/reference/cli/pixi/build_extender:example"
diff --git a/docs/reference/cli/pixi/clean.md b/docs/reference/cli/pixi/clean.md
index 4765e1ac21..9fbcac5664 100644
--- a/docs/reference/cli/pixi/clean.md
+++ b/docs/reference/cli/pixi/clean.md
@@ -4,7 +4,7 @@
 ## About
 Cleanup the environments
 
---8<-- "docs/reference/cli/pixi/clean_extender.md:description"
+--8<-- "docs/reference/cli/pixi/clean_extender:description"
 
 ## Usage
 ```
@@ -35,4 +35,4 @@ This command removes the information in the .pixi folder. You can specify the en
 Use the `cache` subcommand to clean the cache.
 
 
---8<-- "docs/reference/cli/pixi/clean_extender.md:example"
+--8<-- "docs/reference/cli/pixi/clean_extender:example"
diff --git a/docs/reference/cli/pixi/clean/cache.md b/docs/reference/cli/pixi/clean/cache.md
index badcc88b9d..1e4fc437f8 100644
--- a/docs/reference/cli/pixi/clean/cache.md
+++ b/docs/reference/cli/pixi/clean/cache.md
@@ -4,7 +4,7 @@
 ## About
 Clean the cache of your system which are touched by pixi
 
---8<-- "docs/reference/cli/pixi/clean/cache_extender.md:description"
+--8<-- "docs/reference/cli/pixi/clean/cache_extender:description"
 
 ## Usage
 ```
@@ -33,4 +33,4 @@ Clean the cache of your system which are touched by pixi.
 Specify the cache type to clean with the flags.
 
 
---8<-- "docs/reference/cli/pixi/clean/cache_extender.md:example"
+--8<-- "docs/reference/cli/pixi/clean/cache_extender:example"
diff --git a/docs/reference/cli/pixi/clean/cache_extender.md b/docs/reference/cli/pixi/clean/cache_extender
similarity index 100%
rename from docs/reference/cli/pixi/clean/cache_extender.md
rename to docs/reference/cli/pixi/clean/cache_extender
diff --git a/docs/reference/cli/pixi/completion.md b/docs/reference/cli/pixi/completion.md
index c5fa839ad0..ee3b5b6aa8 100644
--- a/docs/reference/cli/pixi/completion.md
+++ b/docs/reference/cli/pixi/completion.md
@@ -4,7 +4,7 @@
 ## About
 Generates a completion script for a shell
 
---8<-- "docs/reference/cli/pixi/completion_extender.md:description"
+--8<-- "docs/reference/cli/pixi/completion_extender:description"
 
 ## Usage
 ```
@@ -17,4 +17,4 @@ pixi completion --shell <SHELL>
 <br>**required**: `true`
 <br>**options**: `bash`, `elvish`, `fish`, `nushell`, `powershell`, `zsh`
 
---8<-- "docs/reference/cli/pixi/completion_extender.md:example"
+--8<-- "docs/reference/cli/pixi/completion_extender:example"
diff --git a/docs/reference/cli/pixi/config.md b/docs/reference/cli/pixi/config.md
index 47d5e39cb0..db15b001b3 100644
--- a/docs/reference/cli/pixi/config.md
+++ b/docs/reference/cli/pixi/config.md
@@ -4,7 +4,7 @@
 ## About
 Configuration management
 
---8<-- "docs/reference/cli/pixi/config_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ pixi config <COMMAND>
 | [`unset`](config/unset.md) | Unset a configuration value |
 
 
---8<-- "docs/reference/cli/pixi/config_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config_extender:example"
diff --git a/docs/reference/cli/pixi/config/append.md b/docs/reference/cli/pixi/config/append.md
index d3bdc5f490..c3d70a3075 100644
--- a/docs/reference/cli/pixi/config/append.md
+++ b/docs/reference/cli/pixi/config/append.md
@@ -4,7 +4,7 @@
 ## About
 Append a value to a list configuration key
 
---8<-- "docs/reference/cli/pixi/config/append_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/append_extender:description"
 
 ## Usage
 ```
@@ -37,4 +37,4 @@ Append a value to a list configuration key
 Example: `pixi config append default-channels bioconda`
 
 
---8<-- "docs/reference/cli/pixi/config/append_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/append_extender:example"
diff --git a/docs/reference/cli/pixi/config/append_extender.md b/docs/reference/cli/pixi/config/append_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/append_extender.md
rename to docs/reference/cli/pixi/config/append_extender
diff --git a/docs/reference/cli/pixi/config/edit.md b/docs/reference/cli/pixi/config/edit.md
index cd8ae681aa..0c76bc7590 100644
--- a/docs/reference/cli/pixi/config/edit.md
+++ b/docs/reference/cli/pixi/config/edit.md
@@ -4,7 +4,7 @@
 ## About
 Edit the configuration file
 
---8<-- "docs/reference/cli/pixi/config/edit_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/edit_extender:description"
 
 ## Usage
 ```
@@ -28,4 +28,4 @@ pixi config edit [OPTIONS] [EDITOR]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/config/edit_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/edit_extender:example"
diff --git a/docs/reference/cli/pixi/config/edit_extender.md b/docs/reference/cli/pixi/config/edit_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/edit_extender.md
rename to docs/reference/cli/pixi/config/edit_extender
diff --git a/docs/reference/cli/pixi/config/list.md b/docs/reference/cli/pixi/config/list.md
index ecc11494c5..5229f70668 100644
--- a/docs/reference/cli/pixi/config/list.md
+++ b/docs/reference/cli/pixi/config/list.md
@@ -4,7 +4,7 @@
 ## About
 List configuration values
 
---8<-- "docs/reference/cli/pixi/config/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/list_extender:description"
 
 ## Usage
 ```
@@ -37,4 +37,4 @@ List configuration values
 Example: `pixi config list default-channels`
 
 
---8<-- "docs/reference/cli/pixi/config/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/list_extender:example"
diff --git a/docs/reference/cli/pixi/config/list_extender.md b/docs/reference/cli/pixi/config/list_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/list_extender.md
rename to docs/reference/cli/pixi/config/list_extender
diff --git a/docs/reference/cli/pixi/config/prepend.md b/docs/reference/cli/pixi/config/prepend.md
index 27a51f51bf..e74d9bebd0 100644
--- a/docs/reference/cli/pixi/config/prepend.md
+++ b/docs/reference/cli/pixi/config/prepend.md
@@ -4,7 +4,7 @@
 ## About
 Prepend a value to a list configuration key
 
---8<-- "docs/reference/cli/pixi/config/prepend_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/prepend_extender:description"
 
 ## Usage
 ```
@@ -37,4 +37,4 @@ Prepend a value to a list configuration key
 Example: `pixi config prepend default-channels bioconda`
 
 
---8<-- "docs/reference/cli/pixi/config/prepend_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/prepend_extender:example"
diff --git a/docs/reference/cli/pixi/config/prepend_extender.md b/docs/reference/cli/pixi/config/prepend_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/prepend_extender.md
rename to docs/reference/cli/pixi/config/prepend_extender
diff --git a/docs/reference/cli/pixi/config/set.md b/docs/reference/cli/pixi/config/set.md
index 8dbe841aa3..ce7f0b0343 100644
--- a/docs/reference/cli/pixi/config/set.md
+++ b/docs/reference/cli/pixi/config/set.md
@@ -4,7 +4,7 @@
 ## About
 Set a configuration value
 
---8<-- "docs/reference/cli/pixi/config/set_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/set_extender:description"
 
 ## Usage
 ```
@@ -36,4 +36,4 @@ Set a configuration value
 Example: `pixi config set default-channels '["conda-forge", "bioconda"]'`
 
 
---8<-- "docs/reference/cli/pixi/config/set_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/set_extender:example"
diff --git a/docs/reference/cli/pixi/config/set_extender.md b/docs/reference/cli/pixi/config/set_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/set_extender.md
rename to docs/reference/cli/pixi/config/set_extender
diff --git a/docs/reference/cli/pixi/config/unset.md b/docs/reference/cli/pixi/config/unset.md
index aaed40c726..e9f1254bc1 100644
--- a/docs/reference/cli/pixi/config/unset.md
+++ b/docs/reference/cli/pixi/config/unset.md
@@ -4,7 +4,7 @@
 ## About
 Unset a configuration value
 
---8<-- "docs/reference/cli/pixi/config/unset_extender.md:description"
+--8<-- "docs/reference/cli/pixi/config/unset_extender:description"
 
 ## Usage
 ```
@@ -34,4 +34,4 @@ Unset a configuration value
 Example: `pixi config unset default-channels`
 
 
---8<-- "docs/reference/cli/pixi/config/unset_extender.md:example"
+--8<-- "docs/reference/cli/pixi/config/unset_extender:example"
diff --git a/docs/reference/cli/pixi/config/unset_extender.md b/docs/reference/cli/pixi/config/unset_extender
similarity index 100%
rename from docs/reference/cli/pixi/config/unset_extender.md
rename to docs/reference/cli/pixi/config/unset_extender
diff --git a/docs/reference/cli/pixi/exec.md b/docs/reference/cli/pixi/exec.md
index fb1b00150e..b3ac7f9f67 100644
--- a/docs/reference/cli/pixi/exec.md
+++ b/docs/reference/cli/pixi/exec.md
@@ -4,7 +4,7 @@
 ## About
 Run a command and install it in a temporary environment
 
---8<-- "docs/reference/cli/pixi/exec_extender.md:description"
+--8<-- "docs/reference/cli/pixi/exec_extender:description"
 
 ## Usage
 ```
@@ -50,4 +50,4 @@ Run a command and install it in a temporary environment.
 Remove the temporary environments with `pixi clean cache --exec`.
 
 
---8<-- "docs/reference/cli/pixi/exec_extender.md:example"
+--8<-- "docs/reference/cli/pixi/exec_extender:example"
diff --git a/docs/reference/cli/pixi/exec_extender.md b/docs/reference/cli/pixi/exec_extender
similarity index 100%
rename from docs/reference/cli/pixi/exec_extender.md
rename to docs/reference/cli/pixi/exec_extender
diff --git a/docs/reference/cli/pixi/global.md b/docs/reference/cli/pixi/global.md
index d1640b98f9..0f986efeb8 100644
--- a/docs/reference/cli/pixi/global.md
+++ b/docs/reference/cli/pixi/global.md
@@ -4,7 +4,7 @@
 ## About
 Subcommand for global package management actions
 
---8<-- "docs/reference/cli/pixi/global_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global_extender:description"
 
 ## Usage
 ```
@@ -32,4 +32,4 @@ Subcommand for global package management actions.
 Install packages on the user level. Into to the [`$PIXI_HOME`] directory, which defaults to `~/.pixi`.
 
 
---8<-- "docs/reference/cli/pixi/global_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global_extender:example"
diff --git a/docs/reference/cli/pixi/global/add.md b/docs/reference/cli/pixi/global/add.md
index 7c5a80f445..489e13433b 100644
--- a/docs/reference/cli/pixi/global/add.md
+++ b/docs/reference/cli/pixi/global/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds dependencies to an environment
 
---8<-- "docs/reference/cli/pixi/global/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/add_extender:description"
 
 ## Usage
 ```
@@ -47,4 +47,4 @@ Example:
 - `pixi global add --environment my_env pytest pytest-cov --expose pytest=pytest`
 
 
---8<-- "docs/reference/cli/pixi/global/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/add_extender:example"
diff --git a/docs/reference/cli/pixi/global/add_extender.md b/docs/reference/cli/pixi/global/add_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/add_extender.md
rename to docs/reference/cli/pixi/global/add_extender
diff --git a/docs/reference/cli/pixi/global/edit.md b/docs/reference/cli/pixi/global/edit.md
index 6e07a5ad64..52da824896 100644
--- a/docs/reference/cli/pixi/global/edit.md
+++ b/docs/reference/cli/pixi/global/edit.md
@@ -4,7 +4,7 @@
 ## About
 Edit the global manifest file
 
---8<-- "docs/reference/cli/pixi/global/edit_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/edit_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ Edit the global manifest file
 Opens your editor to edit the global manifest file.
 
 
---8<-- "docs/reference/cli/pixi/global/edit_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/edit_extender:example"
diff --git a/docs/reference/cli/pixi/global/edit_extender.md b/docs/reference/cli/pixi/global/edit_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/edit_extender.md
rename to docs/reference/cli/pixi/global/edit_extender
diff --git a/docs/reference/cli/pixi/global/expose.md b/docs/reference/cli/pixi/global/expose.md
index 03856f8a5b..3038a0c597 100644
--- a/docs/reference/cli/pixi/global/expose.md
+++ b/docs/reference/cli/pixi/global/expose.md
@@ -4,7 +4,7 @@
 ## About
 Interact with the exposure of binaries in the global environment
 
---8<-- "docs/reference/cli/pixi/global/expose_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/expose_extender:description"
 
 ## Usage
 ```
@@ -26,4 +26,4 @@ Interact with the exposure of binaries in the global environment
 `pixi global expose remove python310 --environment myenv` will remove the exposed name `python310` from the environment `myenv`
 
 
---8<-- "docs/reference/cli/pixi/global/expose_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/expose_extender:example"
diff --git a/docs/reference/cli/pixi/global/expose/add.md b/docs/reference/cli/pixi/global/expose/add.md
index 9685a75ab2..f0dd8e9e5a 100644
--- a/docs/reference/cli/pixi/global/expose/add.md
+++ b/docs/reference/cli/pixi/global/expose/add.md
@@ -4,7 +4,7 @@
 ## About
 Add exposed binaries from an environment to your global environment
 
---8<-- "docs/reference/cli/pixi/global/expose/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/expose/add_extender:description"
 
 ## Usage
 ```
@@ -43,4 +43,4 @@ Example:
 - `pixi global add --environment my_env pytest pytest-cov --expose pytest=pytest`
 
 
---8<-- "docs/reference/cli/pixi/global/expose/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/expose/add_extender:example"
diff --git a/docs/reference/cli/pixi/global/expose/add_extender.md b/docs/reference/cli/pixi/global/expose/add_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/expose/add_extender.md
rename to docs/reference/cli/pixi/global/expose/add_extender
diff --git a/docs/reference/cli/pixi/global/expose/remove.md b/docs/reference/cli/pixi/global/expose/remove.md
index 84a453642b..d6900e0c9f 100644
--- a/docs/reference/cli/pixi/global/expose/remove.md
+++ b/docs/reference/cli/pixi/global/expose/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove exposed binaries from the global environment
 
---8<-- "docs/reference/cli/pixi/global/expose/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/expose/remove_extender:description"
 
 ## Usage
 ```
@@ -35,4 +35,4 @@ Remove exposed binaries from the global environment
 `pixi global expose remove python310 python3 --environment myenv` will remove the exposed names `python310` and `python3` from the environment `myenv`
 
 
---8<-- "docs/reference/cli/pixi/global/expose/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/expose/remove_extender:example"
diff --git a/docs/reference/cli/pixi/global/expose/remove_extender.md b/docs/reference/cli/pixi/global/expose/remove_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/expose/remove_extender.md
rename to docs/reference/cli/pixi/global/expose/remove_extender
diff --git a/docs/reference/cli/pixi/global/install.md b/docs/reference/cli/pixi/global/install.md
index bda84a4853..3f89c672bd 100644
--- a/docs/reference/cli/pixi/global/install.md
+++ b/docs/reference/cli/pixi/global/install.md
@@ -4,7 +4,7 @@
 ## About
 Installs the defined packages in a globally accessible location and exposes their command line applications.
 
---8<-- "docs/reference/cli/pixi/global/install_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/install_extender:description"
 
 ## Usage
 ```
@@ -60,4 +60,4 @@ Example:
 - `pixi global install --environment science --expose jupyter --expose ipython jupyter ipython polars`
 
 
---8<-- "docs/reference/cli/pixi/global/install_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/install_extender:example"
diff --git a/docs/reference/cli/pixi/global/install_extender.md b/docs/reference/cli/pixi/global/install_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/install_extender.md
rename to docs/reference/cli/pixi/global/install_extender
diff --git a/docs/reference/cli/pixi/global/list.md b/docs/reference/cli/pixi/global/list.md
index 92d730898d..499b004522 100644
--- a/docs/reference/cli/pixi/global/list.md
+++ b/docs/reference/cli/pixi/global/list.md
@@ -4,7 +4,7 @@
 ## About
 Lists all packages previously installed into a globally accessible location via `pixi global install`.
 
---8<-- "docs/reference/cli/pixi/global/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/list_extender:description"
 
 ## Usage
 ```
@@ -51,4 +51,4 @@ Per environment:
 - Green: packages that are explicitly installed.
 
 
---8<-- "docs/reference/cli/pixi/global/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/list_extender:example"
diff --git a/docs/reference/cli/pixi/global/list_extender.md b/docs/reference/cli/pixi/global/list_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/list_extender.md
rename to docs/reference/cli/pixi/global/list_extender
diff --git a/docs/reference/cli/pixi/global/remove.md b/docs/reference/cli/pixi/global/remove.md
index 380bcd08ad..f03eda69e5 100644
--- a/docs/reference/cli/pixi/global/remove.md
+++ b/docs/reference/cli/pixi/global/remove.md
@@ -4,7 +4,7 @@
 ## About
 Removes dependencies from an environment
 
---8<-- "docs/reference/cli/pixi/global/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/remove_extender:description"
 
 ## Usage
 ```
@@ -42,4 +42,4 @@ Use `pixi global uninstall` to remove the whole environment
 Example: `pixi global remove --environment python numpy`
 
 
---8<-- "docs/reference/cli/pixi/global/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/remove_extender:example"
diff --git a/docs/reference/cli/pixi/global/remove_extender.md b/docs/reference/cli/pixi/global/remove_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/remove_extender.md
rename to docs/reference/cli/pixi/global/remove_extender
diff --git a/docs/reference/cli/pixi/global/shortcut.md b/docs/reference/cli/pixi/global/shortcut.md
index 9820d91b4e..05849d9818 100644
--- a/docs/reference/cli/pixi/global/shortcut.md
+++ b/docs/reference/cli/pixi/global/shortcut.md
@@ -4,7 +4,7 @@
 ## About
 Interact with the shortcuts on your machine
 
---8<-- "docs/reference/cli/pixi/global/shortcut_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/shortcut_extender:description"
 
 ## Usage
 ```
@@ -18,4 +18,4 @@ pixi global shortcut <COMMAND>
 | [`remove`](shortcut/remove.md) | Remove shortcuts from your machine |
 
 
---8<-- "docs/reference/cli/pixi/global/shortcut_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/shortcut_extender:example"
diff --git a/docs/reference/cli/pixi/global/shortcut/add.md b/docs/reference/cli/pixi/global/shortcut/add.md
index feaeea256f..cca90829bd 100644
--- a/docs/reference/cli/pixi/global/shortcut/add.md
+++ b/docs/reference/cli/pixi/global/shortcut/add.md
@@ -4,7 +4,7 @@
 ## About
 Add a shortcut from an environment to your machine.
 
---8<-- "docs/reference/cli/pixi/global/shortcut/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/shortcut/add_extender:description"
 
 ## Usage
 ```
@@ -34,4 +34,4 @@ pixi global shortcut add [OPTIONS] --environment <ENVIRONMENT> [PACKAGE]...
 - <a id="arg---concurrent-downloads" href="#arg---concurrent-downloads">`--concurrent-downloads <CONCURRENT_DOWNLOADS>`</a>
 :  Max concurrent network requests, default is `50`
 
---8<-- "docs/reference/cli/pixi/global/shortcut/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/shortcut/add_extender:example"
diff --git a/docs/reference/cli/pixi/global/shortcut/remove.md b/docs/reference/cli/pixi/global/shortcut/remove.md
index 5e0c6d44f1..94baaa3d5f 100644
--- a/docs/reference/cli/pixi/global/shortcut/remove.md
+++ b/docs/reference/cli/pixi/global/shortcut/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove shortcuts from your machine
 
---8<-- "docs/reference/cli/pixi/global/shortcut/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/shortcut/remove_extender:description"
 
 ## Usage
 ```
@@ -29,4 +29,4 @@ pixi global shortcut remove [OPTIONS] [SHORTCUT]...
 - <a id="arg---concurrent-downloads" href="#arg---concurrent-downloads">`--concurrent-downloads <CONCURRENT_DOWNLOADS>`</a>
 :  Max concurrent network requests, default is `50`
 
---8<-- "docs/reference/cli/pixi/global/shortcut/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/shortcut/remove_extender:example"
diff --git a/docs/reference/cli/pixi/global/sync.md b/docs/reference/cli/pixi/global/sync.md
index a009648530..e973d3a380 100644
--- a/docs/reference/cli/pixi/global/sync.md
+++ b/docs/reference/cli/pixi/global/sync.md
@@ -4,7 +4,7 @@
 ## About
 Sync global manifest with installed environments
 
---8<-- "docs/reference/cli/pixi/global/sync_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/sync_extender:description"
 
 ## Usage
 ```
@@ -24,4 +24,4 @@ pixi global sync [OPTIONS]
 - <a id="arg---concurrent-downloads" href="#arg---concurrent-downloads">`--concurrent-downloads <CONCURRENT_DOWNLOADS>`</a>
 :  Max concurrent network requests, default is `50`
 
---8<-- "docs/reference/cli/pixi/global/sync_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/sync_extender:example"
diff --git a/docs/reference/cli/pixi/global/uninstall.md b/docs/reference/cli/pixi/global/uninstall.md
index c87ac64795..aee73d49ec 100644
--- a/docs/reference/cli/pixi/global/uninstall.md
+++ b/docs/reference/cli/pixi/global/uninstall.md
@@ -4,7 +4,7 @@
 ## About
 Uninstalls environments from the global environment.
 
---8<-- "docs/reference/cli/pixi/global/uninstall_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/uninstall_extender:description"
 
 ## Usage
 ```
@@ -36,4 +36,4 @@ Uninstalls environments from the global environment.
 Example: `pixi global uninstall pixi-pack rattler-build`
 
 
---8<-- "docs/reference/cli/pixi/global/uninstall_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/uninstall_extender:example"
diff --git a/docs/reference/cli/pixi/global/uninstall_extender.md b/docs/reference/cli/pixi/global/uninstall_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/uninstall_extender.md
rename to docs/reference/cli/pixi/global/uninstall_extender
diff --git a/docs/reference/cli/pixi/global/update.md b/docs/reference/cli/pixi/global/update.md
index e98fa87286..6fe5498255 100644
--- a/docs/reference/cli/pixi/global/update.md
+++ b/docs/reference/cli/pixi/global/update.md
@@ -4,7 +4,7 @@
 ## About
 Updates environments in the global environment
 
---8<-- "docs/reference/cli/pixi/global/update_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/update_extender:description"
 
 ## Usage
 ```
@@ -29,4 +29,4 @@ pixi global update [OPTIONS] [ENVIRONMENTS]...
 - <a id="arg---concurrent-downloads" href="#arg---concurrent-downloads">`--concurrent-downloads <CONCURRENT_DOWNLOADS>`</a>
 :  Max concurrent network requests, default is `50`
 
---8<-- "docs/reference/cli/pixi/global/update_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/update_extender:example"
diff --git a/docs/reference/cli/pixi/global/update_extender.md b/docs/reference/cli/pixi/global/update_extender
similarity index 100%
rename from docs/reference/cli/pixi/global/update_extender.md
rename to docs/reference/cli/pixi/global/update_extender
diff --git a/docs/reference/cli/pixi/global/upgrade-all.md b/docs/reference/cli/pixi/global/upgrade-all.md
index a6eaa6bb33..6728bbea1f 100644
--- a/docs/reference/cli/pixi/global/upgrade-all.md
+++ b/docs/reference/cli/pixi/global/upgrade-all.md
@@ -4,7 +4,7 @@
 ## About
 Upgrade all globally installed packages This command has been removed, please use `pixi global update` instead
 
---8<-- "docs/reference/cli/pixi/global/upgrade-all_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/upgrade-all_extender:description"
 
 ## Usage
 ```
@@ -32,4 +32,4 @@ pixi global upgrade-all [OPTIONS]
 - <a id="arg---concurrent-downloads" href="#arg---concurrent-downloads">`--concurrent-downloads <CONCURRENT_DOWNLOADS>`</a>
 :  Max concurrent network requests, default is `50`
 
---8<-- "docs/reference/cli/pixi/global/upgrade-all_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/upgrade-all_extender:example"
diff --git a/docs/reference/cli/pixi/global/upgrade.md b/docs/reference/cli/pixi/global/upgrade.md
index 0281293581..8049449fd9 100644
--- a/docs/reference/cli/pixi/global/upgrade.md
+++ b/docs/reference/cli/pixi/global/upgrade.md
@@ -4,7 +4,7 @@
 ## About
 Upgrade specific package which is installed globally. This command has been removed, please use `pixi global update` instead
 
---8<-- "docs/reference/cli/pixi/global/upgrade_extender.md:description"
+--8<-- "docs/reference/cli/pixi/global/upgrade_extender:description"
 
 ## Usage
 ```
@@ -24,4 +24,4 @@ pixi global upgrade [OPTIONS] [SPECS]...
 :  The platform to install the package for
 <br>**default**: `current_platform`
 
---8<-- "docs/reference/cli/pixi/global/upgrade_extender.md:example"
+--8<-- "docs/reference/cli/pixi/global/upgrade_extender:example"
diff --git a/docs/reference/cli/pixi/global_extender.md b/docs/reference/cli/pixi/global_extender
similarity index 100%
rename from docs/reference/cli/pixi/global_extender.md
rename to docs/reference/cli/pixi/global_extender
diff --git a/docs/reference/cli/pixi/info.md b/docs/reference/cli/pixi/info.md
index aa09d8b7f5..5091385629 100644
--- a/docs/reference/cli/pixi/info.md
+++ b/docs/reference/cli/pixi/info.md
@@ -4,7 +4,7 @@
 ## About
 Information about the system, workspace and environments for the current machine
 
---8<-- "docs/reference/cli/pixi/info_extender.md:description"
+--8<-- "docs/reference/cli/pixi/info_extender:description"
 
 ## Usage
 ```
@@ -21,4 +21,4 @@ pixi info [OPTIONS]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/info_extender.md:example"
+--8<-- "docs/reference/cli/pixi/info_extender:example"
diff --git a/docs/reference/cli/pixi/info_extender.md b/docs/reference/cli/pixi/info_extender
similarity index 100%
rename from docs/reference/cli/pixi/info_extender.md
rename to docs/reference/cli/pixi/info_extender
diff --git a/docs/reference/cli/pixi/init.md b/docs/reference/cli/pixi/init.md
index 40d737fb36..99e7a02727 100644
--- a/docs/reference/cli/pixi/init.md
+++ b/docs/reference/cli/pixi/init.md
@@ -4,7 +4,7 @@
 ## About
 Creates a new workspace
 
---8<-- "docs/reference/cli/pixi/init_extender.md:description"
+--8<-- "docs/reference/cli/pixi/init_extender:description"
 
 ## Usage
 ```
@@ -42,4 +42,4 @@ As pixi can both work with `pixi.toml` and `pyproject.toml` files, the user can
 You can import an existing conda environment file with the `--import` flag.
 
 
---8<-- "docs/reference/cli/pixi/init_extender.md:example"
+--8<-- "docs/reference/cli/pixi/init_extender:example"
diff --git a/docs/reference/cli/pixi/init_extender.md b/docs/reference/cli/pixi/init_extender
similarity index 100%
rename from docs/reference/cli/pixi/init_extender.md
rename to docs/reference/cli/pixi/init_extender
diff --git a/docs/reference/cli/pixi/install.md b/docs/reference/cli/pixi/install.md
index ecb3841cd1..06f58fa992 100644
--- a/docs/reference/cli/pixi/install.md
+++ b/docs/reference/cli/pixi/install.md
@@ -4,7 +4,7 @@
 ## About
 Install an environment, both updating the lockfile and installing the environment
 
---8<-- "docs/reference/cli/pixi/install_extender.md:description"
+--8<-- "docs/reference/cli/pixi/install_extender:description"
 
 ## Usage
 ```
@@ -55,4 +55,4 @@ Running `pixi install` is not required before running other commands like `pixi
 You can use `pixi reinstall` to reinstall all environments, one environment or just some packages of an environment.
 
 
---8<-- "docs/reference/cli/pixi/install_extender.md:example"
+--8<-- "docs/reference/cli/pixi/install_extender:example"
diff --git a/docs/reference/cli/pixi/install_extender.md b/docs/reference/cli/pixi/install_extender
similarity index 100%
rename from docs/reference/cli/pixi/install_extender.md
rename to docs/reference/cli/pixi/install_extender
diff --git a/docs/reference/cli/pixi/list.md b/docs/reference/cli/pixi/list.md
index 413982fd1b..c85076c3c2 100644
--- a/docs/reference/cli/pixi/list.md
+++ b/docs/reference/cli/pixi/list.md
@@ -4,7 +4,7 @@
 ## About
 List workspace's packages
 
---8<-- "docs/reference/cli/pixi/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/list_extender:description"
 
 ## Usage
 ```
@@ -51,4 +51,4 @@ List workspace's packages.
 Highlighted packages are explicit dependencies.
 
 
---8<-- "docs/reference/cli/pixi/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/list_extender:example"
diff --git a/docs/reference/cli/pixi/list_extender.md b/docs/reference/cli/pixi/list_extender
similarity index 100%
rename from docs/reference/cli/pixi/list_extender.md
rename to docs/reference/cli/pixi/list_extender
diff --git a/docs/reference/cli/pixi/lock.md b/docs/reference/cli/pixi/lock.md
index 7e6240dc66..9c70b657d7 100644
--- a/docs/reference/cli/pixi/lock.md
+++ b/docs/reference/cli/pixi/lock.md
@@ -4,7 +4,7 @@
 ## About
 Solve environment and update the lock file without installing the environments
 
---8<-- "docs/reference/cli/pixi/lock_extender.md:description"
+--8<-- "docs/reference/cli/pixi/lock_extender:description"
 
 ## Usage
 ```
@@ -19,4 +19,4 @@ pixi lock [OPTIONS]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/lock_extender.md:example"
+--8<-- "docs/reference/cli/pixi/lock_extender:example"
diff --git a/docs/reference/cli/pixi/lock_extender.md b/docs/reference/cli/pixi/lock_extender
similarity index 100%
rename from docs/reference/cli/pixi/lock_extender.md
rename to docs/reference/cli/pixi/lock_extender
diff --git a/docs/reference/cli/pixi/reinstall.md b/docs/reference/cli/pixi/reinstall.md
index bb3e442ef6..67ded3d323 100644
--- a/docs/reference/cli/pixi/reinstall.md
+++ b/docs/reference/cli/pixi/reinstall.md
@@ -4,7 +4,7 @@
 ## About
 Re-install an environment, both updating the lockfile and re-installing the environment
 
---8<-- "docs/reference/cli/pixi/reinstall_extender.md:description"
+--8<-- "docs/reference/cli/pixi/reinstall_extender:description"
 
 ## Usage
 ```
@@ -56,4 +56,4 @@ This command reinstalls an environment, if the lockfile is not up-to-date it wil
 If you want to re-install all environments, you can use the `--all` flag.
 
 
---8<-- "docs/reference/cli/pixi/reinstall_extender.md:example"
+--8<-- "docs/reference/cli/pixi/reinstall_extender:example"
diff --git a/docs/reference/cli/pixi/remove.md b/docs/reference/cli/pixi/remove.md
index de5b9ff7dd..e99c10cccf 100644
--- a/docs/reference/cli/pixi/remove.md
+++ b/docs/reference/cli/pixi/remove.md
@@ -4,7 +4,7 @@
 ## About
 Removes dependencies from the workspace
 
---8<-- "docs/reference/cli/pixi/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/remove_extender:description"
 
 ## Usage
 ```
@@ -80,4 +80,4 @@ If the workspace manifest is a `pyproject.toml`, removing a pypi dependency with
 - pixi `pypi-dependencies` tables of the default feature or, if a feature is specified, a named feature
 
 
---8<-- "docs/reference/cli/pixi/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/remove_extender:example"
diff --git a/docs/reference/cli/pixi/remove_extender.md b/docs/reference/cli/pixi/remove_extender
similarity index 100%
rename from docs/reference/cli/pixi/remove_extender.md
rename to docs/reference/cli/pixi/remove_extender
diff --git a/docs/reference/cli/pixi/run.md b/docs/reference/cli/pixi/run.md
index 7ef1dee2ad..0585a982ea 100644
--- a/docs/reference/cli/pixi/run.md
+++ b/docs/reference/cli/pixi/run.md
@@ -4,7 +4,7 @@
 ## About
 Runs task in the pixi environment
 
---8<-- "docs/reference/cli/pixi/run_extender.md:description"
+--8<-- "docs/reference/cli/pixi/run_extender:description"
 
 ## Usage
 ```
@@ -70,4 +70,4 @@ This command is used to run tasks in the pixi environment. It will activate the
 `pixi run` will also update the lockfile and install the environment if it is required.
 
 
---8<-- "docs/reference/cli/pixi/run_extender.md:example"
+--8<-- "docs/reference/cli/pixi/run_extender:example"
diff --git a/docs/reference/cli/pixi/run_extender.md b/docs/reference/cli/pixi/run_extender
similarity index 100%
rename from docs/reference/cli/pixi/run_extender.md
rename to docs/reference/cli/pixi/run_extender
diff --git a/docs/reference/cli/pixi/search.md b/docs/reference/cli/pixi/search.md
index 6edf1dc027..5e8cbd1706 100644
--- a/docs/reference/cli/pixi/search.md
+++ b/docs/reference/cli/pixi/search.md
@@ -4,7 +4,7 @@
 ## About
 Search a conda package
 
---8<-- "docs/reference/cli/pixi/search_extender.md:description"
+--8<-- "docs/reference/cli/pixi/search_extender:description"
 
 ## Usage
 ```
@@ -36,4 +36,4 @@ Search a conda package
 Its output will list the latest version of package.
 
 
---8<-- "docs/reference/cli/pixi/search_extender.md:example"
+--8<-- "docs/reference/cli/pixi/search_extender:example"
diff --git a/docs/reference/cli/pixi/search_extender.md b/docs/reference/cli/pixi/search_extender
similarity index 100%
rename from docs/reference/cli/pixi/search_extender.md
rename to docs/reference/cli/pixi/search_extender
diff --git a/docs/reference/cli/pixi/self-update.md b/docs/reference/cli/pixi/self-update.md
index c5399ed03e..efb792d378 100644
--- a/docs/reference/cli/pixi/self-update.md
+++ b/docs/reference/cli/pixi/self-update.md
@@ -4,7 +4,7 @@
 ## About
 Update pixi to the latest version or a specific version
 
---8<-- "docs/reference/cli/pixi/self-update_extender.md:description"
+--8<-- "docs/reference/cli/pixi/self-update_extender:description"
 
 ## Usage
 ```
@@ -15,4 +15,4 @@ pixi self-update
 - <a id="arg---version" href="#arg---version">`--version <VERSION>`</a>
 :  The desired version (to downgrade or upgrade to)
 
---8<-- "docs/reference/cli/pixi/self-update_extender.md:example"
+--8<-- "docs/reference/cli/pixi/self-update_extender:example"
diff --git a/docs/reference/cli/pixi/self-update_extender.md b/docs/reference/cli/pixi/self-update_extender
similarity index 100%
rename from docs/reference/cli/pixi/self-update_extender.md
rename to docs/reference/cli/pixi/self-update_extender
diff --git a/docs/reference/cli/pixi/shell-hook.md b/docs/reference/cli/pixi/shell-hook.md
index 3b2ae2345a..a290caadb5 100644
--- a/docs/reference/cli/pixi/shell-hook.md
+++ b/docs/reference/cli/pixi/shell-hook.md
@@ -4,7 +4,7 @@
 ## About
 Print the pixi environment activation script
 
---8<-- "docs/reference/cli/pixi/shell-hook_extender.md:description"
+--8<-- "docs/reference/cli/pixi/shell-hook_extender:description"
 
 ## Usage
 ```
@@ -65,4 +65,4 @@ Print the pixi environment activation script.
 You can source the script to activate the environment without needing pixi itself.
 
 
---8<-- "docs/reference/cli/pixi/shell-hook_extender.md:example"
+--8<-- "docs/reference/cli/pixi/shell-hook_extender:example"
diff --git a/docs/reference/cli/pixi/shell-hook_extender.md b/docs/reference/cli/pixi/shell-hook_extender
similarity index 100%
rename from docs/reference/cli/pixi/shell-hook_extender.md
rename to docs/reference/cli/pixi/shell-hook_extender
diff --git a/docs/reference/cli/pixi/shell.md b/docs/reference/cli/pixi/shell.md
index 85190a5ce7..baf02682cb 100644
--- a/docs/reference/cli/pixi/shell.md
+++ b/docs/reference/cli/pixi/shell.md
@@ -4,7 +4,7 @@
 ## About
 Start a shell in a pixi environment, run `exit` to leave the shell
 
---8<-- "docs/reference/cli/pixi/shell_extender.md:description"
+--8<-- "docs/reference/cli/pixi/shell_extender:description"
 
 ## Usage
 ```
@@ -52,4 +52,4 @@ pixi shell [OPTIONS]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/shell_extender.md:example"
+--8<-- "docs/reference/cli/pixi/shell_extender:example"
diff --git a/docs/reference/cli/pixi/shell_extender.md b/docs/reference/cli/pixi/shell_extender
similarity index 100%
rename from docs/reference/cli/pixi/shell_extender.md
rename to docs/reference/cli/pixi/shell_extender
diff --git a/docs/reference/cli/pixi/task.md b/docs/reference/cli/pixi/task.md
index dfec3c21db..282ce08152 100644
--- a/docs/reference/cli/pixi/task.md
+++ b/docs/reference/cli/pixi/task.md
@@ -4,7 +4,7 @@
 ## About
 Interact with tasks in the workspace
 
---8<-- "docs/reference/cli/pixi/task_extender.md:description"
+--8<-- "docs/reference/cli/pixi/task_extender:description"
 
 ## Usage
 ```
@@ -24,4 +24,4 @@ pixi task [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/task_extender.md:example"
+--8<-- "docs/reference/cli/pixi/task_extender:example"
diff --git a/docs/reference/cli/pixi/task/add.md b/docs/reference/cli/pixi/task/add.md
index 568035b103..3ecb85a97a 100644
--- a/docs/reference/cli/pixi/task/add.md
+++ b/docs/reference/cli/pixi/task/add.md
@@ -4,7 +4,7 @@
 ## About
 Add a command to the workspace
 
---8<-- "docs/reference/cli/pixi/task/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/task/add_extender:description"
 
 ## Usage
 ```
@@ -38,4 +38,4 @@ pixi task add [OPTIONS] <NAME> <COMMAND>...
 - <a id="arg---clean-env" href="#arg---clean-env">`--clean-env`</a>
 :  Isolate the task from the shell environment, and only use the pixi environment to run the task
 
---8<-- "docs/reference/cli/pixi/task/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/task/add_extender:example"
diff --git a/docs/reference/cli/pixi/task/add_extender.md b/docs/reference/cli/pixi/task/add_extender
similarity index 100%
rename from docs/reference/cli/pixi/task/add_extender.md
rename to docs/reference/cli/pixi/task/add_extender
diff --git a/docs/reference/cli/pixi/task/alias.md b/docs/reference/cli/pixi/task/alias.md
index 4c6f8d3c2b..885313d256 100644
--- a/docs/reference/cli/pixi/task/alias.md
+++ b/docs/reference/cli/pixi/task/alias.md
@@ -4,7 +4,7 @@
 ## About
 Alias another specific command
 
---8<-- "docs/reference/cli/pixi/task/alias_extender.md:description"
+--8<-- "docs/reference/cli/pixi/task/alias_extender:description"
 
 ## Usage
 ```
@@ -26,4 +26,4 @@ pixi task alias [OPTIONS] <ALIAS> <DEPENDS_ON>...
 - <a id="arg---description" href="#arg---description">`--description <DESCRIPTION>`</a>
 :  The description of the alias task
 
---8<-- "docs/reference/cli/pixi/task/alias_extender.md:example"
+--8<-- "docs/reference/cli/pixi/task/alias_extender:example"
diff --git a/docs/reference/cli/pixi/task/alias_extender.md b/docs/reference/cli/pixi/task/alias_extender
similarity index 100%
rename from docs/reference/cli/pixi/task/alias_extender.md
rename to docs/reference/cli/pixi/task/alias_extender
diff --git a/docs/reference/cli/pixi/task/list.md b/docs/reference/cli/pixi/task/list.md
index cc2097ad2e..e775574386 100644
--- a/docs/reference/cli/pixi/task/list.md
+++ b/docs/reference/cli/pixi/task/list.md
@@ -4,7 +4,7 @@
 ## About
 List all tasks in the workspace
 
---8<-- "docs/reference/cli/pixi/task/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/task/list_extender:description"
 
 ## Usage
 ```
@@ -19,4 +19,4 @@ pixi task list [OPTIONS]
 - <a id="arg---json" href="#arg---json">`--json`</a>
 :  List as json instead of a tree If not specified, the default environment is used
 
---8<-- "docs/reference/cli/pixi/task/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/task/list_extender:example"
diff --git a/docs/reference/cli/pixi/task/list_extender.md b/docs/reference/cli/pixi/task/list_extender
similarity index 100%
rename from docs/reference/cli/pixi/task/list_extender.md
rename to docs/reference/cli/pixi/task/list_extender
diff --git a/docs/reference/cli/pixi/task/remove.md b/docs/reference/cli/pixi/task/remove.md
index bff681a5d7..192f0cb167 100644
--- a/docs/reference/cli/pixi/task/remove.md
+++ b/docs/reference/cli/pixi/task/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove a command from the workspace
 
---8<-- "docs/reference/cli/pixi/task/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/task/remove_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ pixi task remove [OPTIONS] [TASK_NAME]...
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The feature for which the task should be removed
 
---8<-- "docs/reference/cli/pixi/task/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/task/remove_extender:example"
diff --git a/docs/reference/cli/pixi/task/remove_extender.md b/docs/reference/cli/pixi/task/remove_extender
similarity index 100%
rename from docs/reference/cli/pixi/task/remove_extender.md
rename to docs/reference/cli/pixi/task/remove_extender
diff --git a/docs/reference/cli/pixi/tree.md b/docs/reference/cli/pixi/tree.md
index 8c58fedb4a..45ca589b03 100644
--- a/docs/reference/cli/pixi/tree.md
+++ b/docs/reference/cli/pixi/tree.md
@@ -4,7 +4,7 @@
 ## About
 Show a tree of workspace dependencies
 
---8<-- "docs/reference/cli/pixi/tree_extender.md:description"
+--8<-- "docs/reference/cli/pixi/tree_extender:description"
 
 ## Usage
 ```
@@ -43,4 +43,4 @@ Show a tree of workspace dependencies
 Dependency names highlighted in green are directly specified in the manifest. Yellow version numbers are conda packages, PyPI version numbers are blue.
 
 
---8<-- "docs/reference/cli/pixi/tree_extender.md:example"
+--8<-- "docs/reference/cli/pixi/tree_extender:example"
diff --git a/docs/reference/cli/pixi/tree_extender.md b/docs/reference/cli/pixi/tree_extender
similarity index 100%
rename from docs/reference/cli/pixi/tree_extender.md
rename to docs/reference/cli/pixi/tree_extender
diff --git a/docs/reference/cli/pixi/update.md b/docs/reference/cli/pixi/update.md
index 27edfcbba4..a7b7511e02 100644
--- a/docs/reference/cli/pixi/update.md
+++ b/docs/reference/cli/pixi/update.md
@@ -4,7 +4,7 @@
 ## About
 The `update` command checks if there are newer versions of the dependencies and updates the `pixi.lock` file and environments accordingly
 
---8<-- "docs/reference/cli/pixi/update_extender.md:description"
+--8<-- "docs/reference/cli/pixi/update_extender:description"
 
 ## Usage
 ```
@@ -53,4 +53,4 @@ The `update` command checks if there are newer versions of the dependencies and
 It will only update the lock file if the dependencies in the manifest file are still compatible with the new versions.
 
 
---8<-- "docs/reference/cli/pixi/update_extender.md:example"
+--8<-- "docs/reference/cli/pixi/update_extender:example"
diff --git a/docs/reference/cli/pixi/update_extender.md b/docs/reference/cli/pixi/update_extender
similarity index 100%
rename from docs/reference/cli/pixi/update_extender.md
rename to docs/reference/cli/pixi/update_extender
diff --git a/docs/reference/cli/pixi/upgrade.md b/docs/reference/cli/pixi/upgrade.md
index 903e852ada..a1fa3c1db0 100644
--- a/docs/reference/cli/pixi/upgrade.md
+++ b/docs/reference/cli/pixi/upgrade.md
@@ -4,7 +4,7 @@
 ## About
 Checks if there are newer versions of the dependencies and upgrades them in the lockfile and manifest file
 
---8<-- "docs/reference/cli/pixi/upgrade_extender.md:description"
+--8<-- "docs/reference/cli/pixi/upgrade_extender:description"
 
 ## Usage
 ```
@@ -63,4 +63,4 @@ Checks if there are newer versions of the dependencies and upgrades them in the
 `pixi upgrade` loosens the requirements for the given packages, updates the lock file and the adapts the manifest accordingly.
 
 
---8<-- "docs/reference/cli/pixi/upgrade_extender.md:example"
+--8<-- "docs/reference/cli/pixi/upgrade_extender:example"
diff --git a/docs/reference/cli/pixi/upgrade_extender.md b/docs/reference/cli/pixi/upgrade_extender
similarity index 100%
rename from docs/reference/cli/pixi/upgrade_extender.md
rename to docs/reference/cli/pixi/upgrade_extender
diff --git a/docs/reference/cli/pixi/upload.md b/docs/reference/cli/pixi/upload.md
index 39743ac417..49bafa2d71 100644
--- a/docs/reference/cli/pixi/upload.md
+++ b/docs/reference/cli/pixi/upload.md
@@ -4,7 +4,7 @@
 ## About
 Upload a conda package
 
---8<-- "docs/reference/cli/pixi/upload_extender.md:description"
+--8<-- "docs/reference/cli/pixi/upload_extender:description"
 
 ## Usage
 ```
@@ -27,4 +27,4 @@ With this command, you can upload a conda package to a channel. Example: `pixi u
 Use `pixi auth login` to authenticate with the server.
 
 
---8<-- "docs/reference/cli/pixi/upload_extender.md:example"
+--8<-- "docs/reference/cli/pixi/upload_extender:example"
diff --git a/docs/reference/cli/pixi/workspace.md b/docs/reference/cli/pixi/workspace.md
index a82536b4d6..e46cadcea6 100644
--- a/docs/reference/cli/pixi/workspace.md
+++ b/docs/reference/cli/pixi/workspace.md
@@ -4,7 +4,7 @@
 ## About
 Modify the workspace configuration file through the command line
 
---8<-- "docs/reference/cli/pixi/workspace_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace_extender:description"
 
 ## Usage
 ```
@@ -29,4 +29,4 @@ pixi workspace [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/channel.md b/docs/reference/cli/pixi/workspace/channel.md
index bf70f1c913..09ba262745 100644
--- a/docs/reference/cli/pixi/workspace/channel.md
+++ b/docs/reference/cli/pixi/workspace/channel.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace channels
 
---8<-- "docs/reference/cli/pixi/workspace/channel_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/channel_extender:description"
 
 ## Usage
 ```
@@ -19,4 +19,4 @@ pixi workspace channel <COMMAND>
 | [`remove`](channel/remove.md) | Remove channel(s) from the manifest and updates the lockfile |
 
 
---8<-- "docs/reference/cli/pixi/workspace/channel_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/channel_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/channel/add.md b/docs/reference/cli/pixi/workspace/channel/add.md
index 26837238d1..5b42db98da 100644
--- a/docs/reference/cli/pixi/workspace/channel/add.md
+++ b/docs/reference/cli/pixi/workspace/channel/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds a channel to the manifest and updates the lockfile
 
---8<-- "docs/reference/cli/pixi/workspace/channel/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/channel/add_extender:description"
 
 ## Usage
 ```
@@ -56,4 +56,4 @@ pixi workspace channel add [OPTIONS] <CHANNEL>...
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/channel/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/channel/add_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/channel/list.md b/docs/reference/cli/pixi/workspace/channel/list.md
index a65b7cdb2b..4ddcccd0bb 100644
--- a/docs/reference/cli/pixi/workspace/channel/list.md
+++ b/docs/reference/cli/pixi/workspace/channel/list.md
@@ -4,7 +4,7 @@
 ## About
 List the channels in the manifest
 
---8<-- "docs/reference/cli/pixi/workspace/channel/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/channel/list_extender:description"
 
 ## Usage
 ```
@@ -19,4 +19,4 @@ pixi workspace channel list [OPTIONS]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/channel/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/channel/list_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/channel/remove.md b/docs/reference/cli/pixi/workspace/channel/remove.md
index 6509c32eb0..0a37d13a14 100644
--- a/docs/reference/cli/pixi/workspace/channel/remove.md
+++ b/docs/reference/cli/pixi/workspace/channel/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove channel(s) from the manifest and updates the lockfile
 
---8<-- "docs/reference/cli/pixi/workspace/channel/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/channel/remove_extender:description"
 
 ## Usage
 ```
@@ -56,4 +56,4 @@ pixi workspace channel remove [OPTIONS] <CHANNEL>...
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/channel/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/channel/remove_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/description.md b/docs/reference/cli/pixi/workspace/description.md
index ec0a9242d1..ab16797c7d 100644
--- a/docs/reference/cli/pixi/workspace/description.md
+++ b/docs/reference/cli/pixi/workspace/description.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace description
 
---8<-- "docs/reference/cli/pixi/workspace/description_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/description_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ pixi workspace description [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/description_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/description_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/description/get.md b/docs/reference/cli/pixi/workspace/description/get.md
index 701356c4e0..8bfdebb9b7 100644
--- a/docs/reference/cli/pixi/workspace/description/get.md
+++ b/docs/reference/cli/pixi/workspace/description/get.md
@@ -4,7 +4,7 @@
 ## About
 Get the workspace description
 
---8<-- "docs/reference/cli/pixi/workspace/description/get_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/description/get_extender:description"
 
 ## Usage
 ```
@@ -17,4 +17,4 @@ Get the workspace description.
 Example: `pixi workspace description get`
 
 
---8<-- "docs/reference/cli/pixi/workspace/description/get_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/description/get_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/description/set.md b/docs/reference/cli/pixi/workspace/description/set.md
index 5bdb7630af..7fadf51591 100644
--- a/docs/reference/cli/pixi/workspace/description/set.md
+++ b/docs/reference/cli/pixi/workspace/description/set.md
@@ -4,7 +4,7 @@
 ## About
 Set the workspace description
 
---8<-- "docs/reference/cli/pixi/workspace/description/set_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/description/set_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ Set the workspace description.
 Example: `pixi workspace description set "My awesome workspace"`
 
 
---8<-- "docs/reference/cli/pixi/workspace/description/set_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/description/set_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/environment.md b/docs/reference/cli/pixi/workspace/environment.md
index 5d3920a4fb..aa86ebd779 100644
--- a/docs/reference/cli/pixi/workspace/environment.md
+++ b/docs/reference/cli/pixi/workspace/environment.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage project environments
 
---8<-- "docs/reference/cli/pixi/workspace/environment_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/environment_extender:description"
 
 ## Usage
 ```
@@ -23,4 +23,4 @@ pixi workspace environment [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/environment_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/environment_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/environment/add.md b/docs/reference/cli/pixi/workspace/environment/add.md
index 54d2a4e99e..9a277c7d33 100644
--- a/docs/reference/cli/pixi/workspace/environment/add.md
+++ b/docs/reference/cli/pixi/workspace/environment/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds an environment to the manifest file
 
---8<-- "docs/reference/cli/pixi/workspace/environment/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/environment/add_extender:description"
 
 ## Usage
 ```
@@ -29,4 +29,4 @@ pixi workspace environment add [OPTIONS] <NAME>
 :  Update the manifest even if the environment already exists
 <br>**default**: `false`
 
---8<-- "docs/reference/cli/pixi/workspace/environment/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/environment/add_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/environment/list.md b/docs/reference/cli/pixi/workspace/environment/list.md
index 4022eb3d3f..d8cd00b464 100644
--- a/docs/reference/cli/pixi/workspace/environment/list.md
+++ b/docs/reference/cli/pixi/workspace/environment/list.md
@@ -4,11 +4,11 @@
 ## About
 List the environments in the manifest file
 
---8<-- "docs/reference/cli/pixi/workspace/environment/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/environment/list_extender:description"
 
 ## Usage
 ```
 pixi workspace environment list
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/environment/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/environment/list_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/environment/remove.md b/docs/reference/cli/pixi/workspace/environment/remove.md
index 62a8ae1da3..d937d566dd 100644
--- a/docs/reference/cli/pixi/workspace/environment/remove.md
+++ b/docs/reference/cli/pixi/workspace/environment/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove an environment from the manifest file
 
---8<-- "docs/reference/cli/pixi/workspace/environment/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/environment/remove_extender:description"
 
 ## Usage
 ```
@@ -16,4 +16,4 @@ pixi workspace environment remove <NAME>
 :  The name of the environment to remove
 <br>**required**: `true`
 
---8<-- "docs/reference/cli/pixi/workspace/environment/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/environment/remove_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/export.md b/docs/reference/cli/pixi/workspace/export.md
index 8afeb014b7..4f4e51b40b 100644
--- a/docs/reference/cli/pixi/workspace/export.md
+++ b/docs/reference/cli/pixi/workspace/export.md
@@ -4,7 +4,7 @@
 ## About
 Commands to export workspaces to other formats
 
---8<-- "docs/reference/cli/pixi/workspace/export_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/export_extender:description"
 
 ## Usage
 ```
@@ -18,4 +18,4 @@ pixi workspace export <COMMAND>
 | [`conda-environment`](export/conda-environment.md) | Export workspace environment to a conda environment.yaml file |
 
 
---8<-- "docs/reference/cli/pixi/workspace/export_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/export_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/export/conda-environment.md b/docs/reference/cli/pixi/workspace/export/conda-environment.md
index 53083d4e2b..6a8f736e97 100644
--- a/docs/reference/cli/pixi/workspace/export/conda-environment.md
+++ b/docs/reference/cli/pixi/workspace/export/conda-environment.md
@@ -4,7 +4,7 @@
 ## About
 Export workspace environment to a conda environment.yaml file
 
---8<-- "docs/reference/cli/pixi/workspace/export/conda-environment_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/export/conda-environment_extender:description"
 
 ## Usage
 ```
@@ -25,4 +25,4 @@ pixi workspace export conda-environment [OPTIONS] [OUTPUT_PATH]
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/export/conda-environment_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/export/conda-environment_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md b/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md
index 648de9a036..d49c2dd7dc 100644
--- a/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md
+++ b/docs/reference/cli/pixi/workspace/export/conda-explicit-spec.md
@@ -4,7 +4,7 @@
 ## About
 Export workspace environment to a conda explicit specification file
 
---8<-- "docs/reference/cli/pixi/workspace/export/conda-explicit-spec_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/export/conda-explicit-spec_extender:description"
 
 ## Usage
 ```
@@ -57,4 +57,4 @@ pixi workspace export conda-explicit-spec [OPTIONS] <OUTPUT_DIR>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/export/conda-explicit-spec_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/export/conda-explicit-spec_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/name.md b/docs/reference/cli/pixi/workspace/name.md
index 1a1120d6fa..dff10a2bb9 100644
--- a/docs/reference/cli/pixi/workspace/name.md
+++ b/docs/reference/cli/pixi/workspace/name.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace name
 
---8<-- "docs/reference/cli/pixi/workspace/name_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/name_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ pixi workspace name [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/name_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/name_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/name/get.md b/docs/reference/cli/pixi/workspace/name/get.md
index c18d5c9274..d060fb16a4 100644
--- a/docs/reference/cli/pixi/workspace/name/get.md
+++ b/docs/reference/cli/pixi/workspace/name/get.md
@@ -4,11 +4,11 @@
 ## About
 Get the workspace name
 
---8<-- "docs/reference/cli/pixi/workspace/name/get_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/name/get_extender:description"
 
 ## Usage
 ```
 pixi workspace name get
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/name/get_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/name/get_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/name/set.md b/docs/reference/cli/pixi/workspace/name/set.md
index e2e6aba599..ae37a6de80 100644
--- a/docs/reference/cli/pixi/workspace/name/set.md
+++ b/docs/reference/cli/pixi/workspace/name/set.md
@@ -4,7 +4,7 @@
 ## About
 Set the workspace name
 
---8<-- "docs/reference/cli/pixi/workspace/name/set_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/name/set_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ Set the workspace name.
 Example: `pixi workspace name set "my-workspace"`
 
 
---8<-- "docs/reference/cli/pixi/workspace/name/set_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/name/set_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/platform.md b/docs/reference/cli/pixi/workspace/platform.md
index 9b6fb04230..7a17b86444 100644
--- a/docs/reference/cli/pixi/workspace/platform.md
+++ b/docs/reference/cli/pixi/workspace/platform.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace platforms
 
---8<-- "docs/reference/cli/pixi/workspace/platform_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/platform_extender:description"
 
 ## Usage
 ```
@@ -23,4 +23,4 @@ pixi workspace platform [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/platform_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/platform_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/platform/add.md b/docs/reference/cli/pixi/workspace/platform/add.md
index 76beec80b6..bd1ded3bb8 100644
--- a/docs/reference/cli/pixi/workspace/platform/add.md
+++ b/docs/reference/cli/pixi/workspace/platform/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds a platform(s) to the workspace file and updates the lockfile
 
---8<-- "docs/reference/cli/pixi/workspace/platform/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/platform/add_extender:description"
 
 ## Usage
 ```
@@ -23,4 +23,4 @@ pixi workspace platform add [OPTIONS] <PLATFORM>...
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The name of the feature to add the platform to
 
---8<-- "docs/reference/cli/pixi/workspace/platform/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/platform/add_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/platform/list.md b/docs/reference/cli/pixi/workspace/platform/list.md
index 4bc755d6e5..4c53063feb 100644
--- a/docs/reference/cli/pixi/workspace/platform/list.md
+++ b/docs/reference/cli/pixi/workspace/platform/list.md
@@ -4,11 +4,11 @@
 ## About
 List the platforms in the workspace file
 
---8<-- "docs/reference/cli/pixi/workspace/platform/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/platform/list_extender:description"
 
 ## Usage
 ```
 pixi workspace platform list
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/platform/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/platform/list_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/platform/remove.md b/docs/reference/cli/pixi/workspace/platform/remove.md
index e5d278696b..e3420ac10a 100644
--- a/docs/reference/cli/pixi/workspace/platform/remove.md
+++ b/docs/reference/cli/pixi/workspace/platform/remove.md
@@ -4,7 +4,7 @@
 ## About
 Remove platform(s) from the workspace file and updates the lockfile
 
---8<-- "docs/reference/cli/pixi/workspace/platform/remove_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/platform/remove_extender:description"
 
 ## Usage
 ```
@@ -23,4 +23,4 @@ pixi workspace platform remove [OPTIONS] <PLATFORM>...
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The name of the feature to remove the platform from
 
---8<-- "docs/reference/cli/pixi/workspace/platform/remove_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/platform/remove_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/requires-pixi.md b/docs/reference/cli/pixi/workspace/requires-pixi.md
index c5a41c5e4c..bdefc37bd0 100644
--- a/docs/reference/cli/pixi/workspace/requires-pixi.md
+++ b/docs/reference/cli/pixi/workspace/requires-pixi.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage the pixi minimum version requirement
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi_extender:description"
 
 ## Usage
 ```
@@ -24,4 +24,4 @@ pixi workspace requires-pixi [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/requires-pixi/get.md b/docs/reference/cli/pixi/workspace/requires-pixi/get.md
index 13fb6780cb..b7faa065df 100644
--- a/docs/reference/cli/pixi/workspace/requires-pixi/get.md
+++ b/docs/reference/cli/pixi/workspace/requires-pixi/get.md
@@ -4,11 +4,11 @@
 ## About
 Get the pixi minimum version requirement
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/get_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/get_extender:description"
 
 ## Usage
 ```
 pixi workspace requires-pixi get
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/get_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/get_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/requires-pixi/set.md b/docs/reference/cli/pixi/workspace/requires-pixi/set.md
index 48cbf1f6c2..d573182d0e 100644
--- a/docs/reference/cli/pixi/workspace/requires-pixi/set.md
+++ b/docs/reference/cli/pixi/workspace/requires-pixi/set.md
@@ -4,7 +4,7 @@
 ## About
 Set the pixi minimum version requirement
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/set_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/set_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ Set the pixi minimum version requirement.
 Example: `pixi workspace pixi-minimum set 0.42`
 
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/set_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/set_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/requires-pixi/unset.md b/docs/reference/cli/pixi/workspace/requires-pixi/unset.md
index e440a5b7d4..cfb88e949d 100644
--- a/docs/reference/cli/pixi/workspace/requires-pixi/unset.md
+++ b/docs/reference/cli/pixi/workspace/requires-pixi/unset.md
@@ -4,11 +4,11 @@
 ## About
 Remove the pixi minimum version requirement
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/unset_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/unset_extender:description"
 
 ## Usage
 ```
 pixi workspace requires-pixi unset
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/unset_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/unset_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/requires-pixi/verify.md b/docs/reference/cli/pixi/workspace/requires-pixi/verify.md
index 40cf770194..e87a00d6e6 100644
--- a/docs/reference/cli/pixi/workspace/requires-pixi/verify.md
+++ b/docs/reference/cli/pixi/workspace/requires-pixi/verify.md
@@ -4,11 +4,11 @@
 ## About
 Verify the pixi minimum version requirement
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/verify_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/verify_extender:description"
 
 ## Usage
 ```
 pixi workspace requires-pixi verify
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/requires-pixi/verify_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/requires-pixi/verify_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/system-requirements.md b/docs/reference/cli/pixi/workspace/system-requirements.md
index aed891c758..7b4f539d24 100644
--- a/docs/reference/cli/pixi/workspace/system-requirements.md
+++ b/docs/reference/cli/pixi/workspace/system-requirements.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace system requirements
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements_extender:description"
 
 ## Usage
 ```
@@ -22,4 +22,4 @@ pixi workspace system-requirements [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/system-requirements/add.md b/docs/reference/cli/pixi/workspace/system-requirements/add.md
index 0dfb0bf1e2..7eeb193ccd 100644
--- a/docs/reference/cli/pixi/workspace/system-requirements/add.md
+++ b/docs/reference/cli/pixi/workspace/system-requirements/add.md
@@ -4,7 +4,7 @@
 ## About
 Adds an environment to the manifest file
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements/add_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements/add_extender:description"
 
 ## Usage
 ```
@@ -26,4 +26,4 @@ pixi workspace system-requirements add [OPTIONS] <REQUIREMENT> <VERSION>
 - <a id="arg---feature" href="#arg---feature">`--feature (-f) <FEATURE>`</a>
 :  The name of the feature to modify
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements/add_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements/add_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/system-requirements/list.md b/docs/reference/cli/pixi/workspace/system-requirements/list.md
index abeec33ecc..5d2173682b 100644
--- a/docs/reference/cli/pixi/workspace/system-requirements/list.md
+++ b/docs/reference/cli/pixi/workspace/system-requirements/list.md
@@ -4,7 +4,7 @@
 ## About
 List the environments in the manifest file
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements/list_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements/list_extender:description"
 
 ## Usage
 ```
@@ -17,4 +17,4 @@ pixi workspace system-requirements list [OPTIONS]
 - <a id="arg---environment" href="#arg---environment">`--environment (-e) <ENVIRONMENT>`</a>
 :  The environment to list the system requirements for
 
---8<-- "docs/reference/cli/pixi/workspace/system-requirements/list_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/system-requirements/list_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version.md b/docs/reference/cli/pixi/workspace/version.md
index 3d2ff21d5c..ce689462b6 100644
--- a/docs/reference/cli/pixi/workspace/version.md
+++ b/docs/reference/cli/pixi/workspace/version.md
@@ -4,7 +4,7 @@
 ## About
 Commands to manage workspace version
 
---8<-- "docs/reference/cli/pixi/workspace/version_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version_extender:description"
 
 ## Usage
 ```
@@ -25,4 +25,4 @@ pixi workspace version [OPTIONS] <COMMAND>
 - <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path <MANIFEST_PATH>`</a>
 :  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
 
---8<-- "docs/reference/cli/pixi/workspace/version_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version/get.md b/docs/reference/cli/pixi/workspace/version/get.md
index 08ae87f567..1f6227cf3a 100644
--- a/docs/reference/cli/pixi/workspace/version/get.md
+++ b/docs/reference/cli/pixi/workspace/version/get.md
@@ -4,11 +4,11 @@
 ## About
 Get the workspace version
 
---8<-- "docs/reference/cli/pixi/workspace/version/get_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version/get_extender:description"
 
 ## Usage
 ```
 pixi workspace version get
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/version/get_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version/get_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version/major.md b/docs/reference/cli/pixi/workspace/version/major.md
index c06fae2dc4..43acc25a30 100644
--- a/docs/reference/cli/pixi/workspace/version/major.md
+++ b/docs/reference/cli/pixi/workspace/version/major.md
@@ -4,11 +4,11 @@
 ## About
 Bump the workspace version to MAJOR
 
---8<-- "docs/reference/cli/pixi/workspace/version/major_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version/major_extender:description"
 
 ## Usage
 ```
 pixi workspace version major
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/version/major_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version/major_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version/minor.md b/docs/reference/cli/pixi/workspace/version/minor.md
index ba4eec7582..ad98000528 100644
--- a/docs/reference/cli/pixi/workspace/version/minor.md
+++ b/docs/reference/cli/pixi/workspace/version/minor.md
@@ -4,11 +4,11 @@
 ## About
 Bump the workspace version to MINOR
 
---8<-- "docs/reference/cli/pixi/workspace/version/minor_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version/minor_extender:description"
 
 ## Usage
 ```
 pixi workspace version minor
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/version/minor_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version/minor_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version/patch.md b/docs/reference/cli/pixi/workspace/version/patch.md
index d86fac9962..97b579e8d0 100644
--- a/docs/reference/cli/pixi/workspace/version/patch.md
+++ b/docs/reference/cli/pixi/workspace/version/patch.md
@@ -4,11 +4,11 @@
 ## About
 Bump the workspace version to PATCH
 
---8<-- "docs/reference/cli/pixi/workspace/version/patch_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version/patch_extender:description"
 
 ## Usage
 ```
 pixi workspace version patch
 ```
 
---8<-- "docs/reference/cli/pixi/workspace/version/patch_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version/patch_extender:example"
diff --git a/docs/reference/cli/pixi/workspace/version/set.md b/docs/reference/cli/pixi/workspace/version/set.md
index 572726b724..60733482a6 100644
--- a/docs/reference/cli/pixi/workspace/version/set.md
+++ b/docs/reference/cli/pixi/workspace/version/set.md
@@ -4,7 +4,7 @@
 ## About
 Set the workspace version
 
---8<-- "docs/reference/cli/pixi/workspace/version/set_extender.md:description"
+--8<-- "docs/reference/cli/pixi/workspace/version/set_extender:description"
 
 ## Usage
 ```
@@ -16,4 +16,4 @@ pixi workspace version set <VERSION>
 :  The new workspace version
 <br>**required**: `true`
 
---8<-- "docs/reference/cli/pixi/workspace/version/set_extender.md:example"
+--8<-- "docs/reference/cli/pixi/workspace/version/set_extender:example"
diff --git a/docs/reference/cli/pixi_extender.md b/docs/reference/cli/pixi_extender
similarity index 100%
rename from docs/reference/cli/pixi_extender.md
rename to docs/reference/cli/pixi_extender
diff --git a/pixi_docs/src/main.rs b/pixi_docs/src/main.rs
index f2ee384608..bff813291c 100644
--- a/pixi_docs/src/main.rs
+++ b/pixi_docs/src/main.rs
@@ -78,7 +78,7 @@ fn subcommand_to_md(parents: &[String], command: &Command) -> String {
     // Additional description
     writeln!(
         buffer,
-        "\n--8<-- \"docs/reference/cli/{}{}_extender.md:description\"",
+        "\n--8<-- \"docs/reference/cli/{}{}_extender:description\"",
         parent_path,
         command.get_name()
     )
@@ -170,7 +170,7 @@ fn subcommand_to_md(parents: &[String], command: &Command) -> String {
     // Write snippet link
     writeln!(
         buffer,
-        "\n--8<-- \"docs/reference/cli/{}{}_extender.md:example\"",
+        "\n--8<-- \"docs/reference/cli/{}{}_extender:example\"",
         parent_path,
         command.get_name()
     )