diff --git a/doc/dev/contributing.md b/doc/dev/contributing.md
index 57d4967b5..d5766aeda 100644
--- a/doc/dev/contributing.md
+++ b/doc/dev/contributing.md
@@ -1,6 +1,4 @@
-\page contributing_guide Contributing to Deskflow
-
-# Contributing to Deskflow
+# Contributing to Deskflow {#contributing_guide}
 
 Thanks for your interest in contributing to Deskflow! We welcome all kinds of contributions — bug reports, feature suggestions, documentation improvements, and code.
 
diff --git a/doc/dev/protocol_reference.md b/doc/dev/protocol_reference.md
index e72c72006..f80d3ce62 100644
--- a/doc/dev/protocol_reference.md
+++ b/doc/dev/protocol_reference.md
@@ -1,4 +1,4 @@
-# Protocol Reference
+# Protocol Reference {#protocol_reference}
 
 This document provides a comprehensive reference for the Deskflow network protocol. It is the primary source of information for developers implementing Deskflow clients or extending the protocol.
 
diff --git a/src/lib/deskflow/ProtocolTypes.h b/src/lib/deskflow/ProtocolTypes.h
index fca69018d..97aa9c0a7 100644
--- a/src/lib/deskflow/ProtocolTypes.h
+++ b/src/lib/deskflow/ProtocolTypes.h
@@ -20,7 +20,7 @@
  * This file defines the data types, constants, and message structures for the
  * Deskflow network protocol. For a high-level conceptual overview of the protocol,
  * including the distinction between Client/Server and Primary/Secondary roles,
- * please see the **Protocol Reference** document in `doc/dev/protocol_reference.md`.
+ * please see the @ref protocol_reference "Protocol Reference" document.
  */
 
 /**