diff --git a/doc/en/how-to/capture-warnings.rst b/doc/en/how-to/capture-warnings.rst
index 5575c115d..efdf10e33 100644
--- a/doc/en/how-to/capture-warnings.rst
+++ b/doc/en/how-to/capture-warnings.rst
@@ -45,9 +45,9 @@ Running pytest now produces this output:
 Controlling warnings
 --------------------
 
-Similar to Python's `warning filter` and :option:`-W option <python:-W>` flag, pytest provides
+Similar to Python's `warning filter`_ and :option:`-W option <python:-W>` flag, pytest provides
 its own ``-W`` flag to control which warnings are ignored, displayed, or turned into
-errors. See the `warning filter_` documentation for more
+errors. See the `warning filter`_ documentation for more
 advanced use-cases.
 
 .. _`warning filter`: https://docs.python.org/3/library/warnings.html#warning-filter