diff --git a/envoy/api/v2/core/protocol.proto b/envoy/api/v2/core/protocol.proto
index 338f3e6f..4aefc380 100644
--- a/envoy/api/v2/core/protocol.proto
+++ b/envoy/api/v2/core/protocol.proto
@@ -151,7 +151,7 @@ message Http2ProtocolOptions {
   // the whole HTTP/2 connection is terminated upon receiving invalid HEADERS frame. However,
   // when this option is enabled, only the offending stream is terminated.
   //
-  // See [RFC7540, sec. 8.1](https://tools.ietf.org/html/rfc7540#section-8.1) for details.
+  // See `RFC7540, sec. 8.1 <https://tools.ietf.org/html/rfc7540#section-8.1>`_ for details.
   bool stream_error_on_invalid_http_messaging = 12;
 }
 
diff --git a/envoy/api/v2/srds.proto b/envoy/api/v2/srds.proto
index dc11de9f..b9b1e89b 100644
--- a/envoy/api/v2/srds.proto
+++ b/envoy/api/v2/srds.proto
@@ -15,7 +15,7 @@ import "validate/validate.proto";
 
 // [#protodoc-title: HTTP scoped routing configuration]
 // * Routing :ref:`architecture overview <arch_overview_http_routing>`
-//
+
 // The Scoped Routes Discovery Service (SRDS) API distributes
 // :ref:`ScopedRouteConfiguration<envoy_api_msg.ScopedRouteConfiguration>`
 // resources. Each ScopedRouteConfiguration resource represents a "routing
diff --git a/envoy/api/v3alpha/core/protocol.proto b/envoy/api/v3alpha/core/protocol.proto
index 599877f1..2d7b926d 100644
--- a/envoy/api/v3alpha/core/protocol.proto
+++ b/envoy/api/v3alpha/core/protocol.proto
@@ -151,7 +151,7 @@ message Http2ProtocolOptions {
   // the whole HTTP/2 connection is terminated upon receiving invalid HEADERS frame. However,
   // when this option is enabled, only the offending stream is terminated.
   //
-  // See [RFC7540, sec. 8.1](https://tools.ietf.org/html/rfc7540#section-8.1) for details.
+  // See `RFC7540, sec. 8.1 <https://tools.ietf.org/html/rfc7540#section-8.1>`_ for details.
   bool stream_error_on_invalid_http_messaging = 12;
 }
 
diff --git a/envoy/api/v3alpha/srds.proto b/envoy/api/v3alpha/srds.proto
index bfccb0ab..25f8ff59 100644
--- a/envoy/api/v3alpha/srds.proto
+++ b/envoy/api/v3alpha/srds.proto
@@ -15,7 +15,7 @@ import "validate/validate.proto";
 
 // [#protodoc-title: HTTP scoped routing configuration]
 // * Routing :ref:`architecture overview <arch_overview_http_routing>`
-//
+
 // The Scoped Routes Discovery Service (SRDS) API distributes
 // :ref:`ScopedRouteConfiguration<envoy_api_msg.ScopedRouteConfiguration>`
 // resources. Each ScopedRouteConfiguration resource represents a "routing