diff --git a/docs/html/cli/pip_install.rst b/docs/html/cli/pip_install.rst
index 7c17c264a30..44598451af3 100644
--- a/docs/html/cli/pip_install.rst
+++ b/docs/html/cli/pip_install.rst
@@ -386,21 +386,21 @@ Examples
.. code-block:: shell
- python -m pip install SomePackage[PDF]
- python -m pip install "SomePackage[PDF] @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path"
- python -m pip install .[PDF] # project in current directory
- python -m pip install SomePackage[PDF]==3.0
- python -m pip install SomePackage[PDF,EPUB] # multiple extras
+ python -m pip install 'SomePackage[PDF]'
+ python -m pip install 'SomePackage[PDF] @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path'
+ python -m pip install '.[PDF]' # project in current directory
+ python -m pip install 'SomePackage[PDF]==3.0'
+ python -m pip install 'SomePackage[PDF,EPUB]' # multiple extras
.. tab:: Windows
.. code-block:: shell
- py -m pip install SomePackage[PDF]
- py -m pip install "SomePackage[PDF] @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path"
- py -m pip install .[PDF] # project in current directory
- py -m pip install SomePackage[PDF]==3.0
- py -m pip install SomePackage[PDF,EPUB] # multiple extras
+ py -m pip install 'SomePackage[PDF]'
+ py -m pip install 'SomePackage[PDF] @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path'
+ py -m pip install '.[PDF]' # project in current directory
+ py -m pip install 'SomePackage[PDF]==3.0'
+ py -m pip install 'SomePackage[PDF,EPUB]' # multiple extras
#. Install a particular source archive file.
diff --git a/news/11842.doc.rst b/news/11842.doc.rst
new file mode 100644
index 00000000000..bd063996f54
--- /dev/null
+++ b/news/11842.doc.rst
@@ -0,0 +1,2 @@
+Quote extras in the pip install docs to guard shells with default glob
+qualifiers, like zsh.