diff --git a/docs/plugins/duplicates.rst b/docs/plugins/duplicates.rst
index 4580343de..ed94975e9 100644
--- a/docs/plugins/duplicates.rst
+++ b/docs/plugins/duplicates.rst
@@ -57,9 +57,9 @@ file. The available options mirror the command-line options:
 - **delete**: Remove matched items from the library and from the disk. Default:
   ``no``
 - **format**: A specific format with which to print every track or album. This
-  uses the same template syntax as beets' :doc:`path
-  formats</reference/pathformat>`. The usage is inspired by, and therefore
-  similar to, the :ref:`list <list-cmd>` command. Default: :ref:`format_item`
+  uses the same template syntax as beets' :doc:`path formats
+  </reference/pathformat>`. The usage is inspired by, and therefore similar to,
+  the :ref:`list <list-cmd>` command. Default: :ref:`format_item`
 - **full**: List every track or album that has duplicates, not just the
   duplicates themselves. Default: ``no``
 - **keys**: Define in which track or album fields duplicates are to be searched.
diff --git a/docs/plugins/playlist.rst b/docs/plugins/playlist.rst
index e89c880ad..1c1275543 100644
--- a/docs/plugins/playlist.rst
+++ b/docs/plugins/playlist.rst
@@ -29,10 +29,10 @@ searched in the playlist_dir and the ".m3u" extension is appended to the name:
     $ beet ls playlist:anotherplaylist
 
 A playlist query will use the paths found in the playlist file to match items in
-the beets library. ``playlist:`` submits a regular beets :ref:`query<queries>`
-similar to a :ref:`specific fields query<fieldsquery>`. If you want the list in
+the beets library. ``playlist:`` submits a regular beets :ref:`query <queries>`
+similar to a :ref:`specific fields query <fieldsquery>`. If you want the list in
 any particular order, you can use the standard beets query syntax for
-:ref:`sorting<query-sort>`:
+:ref:`sorting <query-sort>`:
 
 ::
 
diff --git a/poetry.lock b/poetry.lock
index a223ae0ad..f3560929b 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -4781,4 +4781,4 @@ web = ["flask", "flask-cors"]
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.10,<4"
-content-hash = "9cff39f63616b2654fbf44b006f7eedcae6c1846fbb9f04af82483891b7d77b9"
+content-hash = "c9f26c3eea9635634fb2fdf4fa5406548bdd6ee3d450ffb4b2263d04315350a0"
diff --git a/pyproject.toml b/pyproject.toml
index 147fbaf90..c34f2b82b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -117,7 +117,7 @@ responses = ">=0.3.0"
 titlecase = "^2.4.1"
 
 [tool.poetry.group.lint.dependencies]
-docstrfmt = ">=1.11.1"
+docstrfmt = ">=2.0.2"
 ruff = ">=0.13.0"
 sphinx-lint = ">=1.0.0"
 
@@ -230,7 +230,7 @@ cmd = "ruff format --config=pyproject.toml"
 
 [tool.poe.tasks.format-docs]
 help = "Format the documentation"
-cmd = "docstrfmt docs *.rst"
+cmd = "docstrfmt --preserve-adornments docs *.rst"
 
 [tool.poe.tasks.lint]
 help = "Check the code for linting issues. Accepts ruff options."