diff --git a/akka-docs/src/main/categories/nesting-and-flattening-operators.md b/akka-docs/src/main/categories/nesting-and-flattening-operators.md
index 7273b250a7..a59136dbfb 100644
--- a/akka-docs/src/main/categories/nesting-and-flattening-operators.md
+++ b/akka-docs/src/main/categories/nesting-and-flattening-operators.md
@@ -1,4 +1,4 @@
 These operators either take a stream and turn it into a stream of streams (nesting) or they take a stream that contains
 nested streams and turn them into a stream of elements instead (flattening).
 
-See the [Substreams](stream-substream.md) page for more detail and code samples.
\ No newline at end of file
+See the @ref:[Substreams](../stream-substream.md) page for more detail and code samples.
diff --git a/akka-docs/src/main/paradox/stream/operators/index.md b/akka-docs/src/main/paradox/stream/operators/index.md
index 61befc4006..cc442c4e1d 100644
--- a/akka-docs/src/main/paradox/stream/operators/index.md
+++ b/akka-docs/src/main/paradox/stream/operators/index.md
@@ -203,7 +203,8 @@ These operators are aware of the backpressure provided by their downstreams and
 These operators either take a stream and turn it into a stream of streams (nesting) or they take a stream that contains
 nested streams and turn them into a stream of elements instead (flattening).
 
-See the [Substreams](stream-substream.md) page for more detail and code samples.
+See the @ref:[Substreams](../stream-substream.md) page for more detail and code samples.
+
 
 | |Operator|Description|
 |--|--|--|