diff --git a/docs/system-booting.rst b/docs/system-booting.rst
index 0b1043bf..6a8443cb 100644
--- a/docs/system-booting.rst
+++ b/docs/system-booting.rst
@@ -86,8 +86,8 @@ Setting up a New Partition for use as Synced ESP
 To format and initialize a partition as synced ESP, for example, after replacing a
 failed vdev in an rpool, ``proxmox-boot-tool`` from ``proxmox-kernel-helper`` can be used.
 
-WARNING: the ``format`` command will format the ``<partition>``. Make sure to pass
-in the right device/partition!
+.. WARNING:: the ``format`` command will format the ``<partition>``. Make sure
+   to pass in the right device/partition!
 
 For example, to format an empty partition ``/dev/sda2`` as ESP, run the following:
 
@@ -243,6 +243,8 @@ and is quite well documented
 (see the `Grub Manual
 <https://www.gnu.org/software/grub/manual/grub/grub.html>`_).
 
+.. _systembooting-grub-config:
+
 Configuration
 ^^^^^^^^^^^^^
 
@@ -300,6 +302,8 @@ Editing the Kernel Commandline
 You can modify the kernel commandline in the following places, depending on the
 bootloader used:
 
+.. _systembooting-kernel-cmdline-grub:
+
 Grub
 ^^^^
 
@@ -308,6 +312,8 @@ The kernel commandline needs to be placed in the variable
 ``update-grub`` appends its content to all ``linux`` entries in
 ``/boot/grub/grub.cfg``.
 
+.. _systembooting-kernel-cmdline-systemd-boot:
+
 systemd-boot
 ^^^^^^^^^^^^