diff --git a/src/pipewire/conf.c b/src/pipewire/conf.c
index e0fe202bb..1d23783b3 100644
--- a/src/pipewire/conf.c
+++ b/src/pipewire/conf.c
@@ -1286,13 +1286,13 @@ int pw_conf_load_conf_for_context(struct pw_properties *props, struct pw_propert
  *             # actions are emitted.
  *             {
  *                 # all keys must match the value. ! negates. ~ starts regex.
- *                 <key> = <value>
+ *                 \<key\> = \<value\>
  *                 ...
  *             }
  *             ...
  *         ]
  *         actions = {
- *             <action> = <value>
+ *             \<action\> = \<value\>
  *             ...
  *         }
  *     }
diff --git a/src/pipewire/context.h b/src/pipewire/context.h
index 5eaa8de30..8c51f15ff 100644
--- a/src/pipewire/context.h
+++ b/src/pipewire/context.h
@@ -29,7 +29,7 @@ extern "C" {
  *    clients.
  *
  *  - Connect to another PipeWire instance (the main daemon, for
- *    example) and interact with it (See \ref page_core_api).
+ *    example) and interact with it (See \ref api_pw_core).
  *
  *  - Export a local implementation of an object to another
  *    instance.
diff --git a/src/pipewire/permission.h b/src/pipewire/permission.h
index 55eeff2a3..37e3c6668 100644
--- a/src/pipewire/permission.h
+++ b/src/pipewire/permission.h
@@ -16,7 +16,7 @@ extern "C" {
  * Permissions are kept for a client and describe what the client is
  * allowed to do with an object.
  *
- * See \ref page_core_api
+ * See \ref api_pw_core
  */
 
 /**