diff --git a/docs/src/main/java/io/quarkus/docs/generation/AssembleDownstreamDocumentation.java b/docs/src/main/java/io/quarkus/docs/generation/AssembleDownstreamDocumentation.java
index 65a974b7e1964..f2438f7f08a56 100755
--- a/docs/src/main/java/io/quarkus/docs/generation/AssembleDownstreamDocumentation.java
+++ b/docs/src/main/java/io/quarkus/docs/generation/AssembleDownstreamDocumentation.java
@@ -57,6 +57,8 @@ public class AssembleDownstreamDocumentation {
             Pattern.CASE_INSENSITIVE);
     private static final Pattern ANGLE_BRACKETS_WITH_DESCRIPTION_PATTERN = Pattern.compile("<<([a-z0-9_\\-#\\.]+?),([^>]+?)>>",
             Pattern.CASE_INSENSITIVE);
+    private static final Pattern ANCHOR_PATTERN = Pattern.compile("^\\[#([a-z0-9_-]+)]$",
+            Pattern.CASE_INSENSITIVE + Pattern.MULTILINE);
     private static final String SOURCE_BLOCK_PREFIX = "[source";
     private static final String SOURCE_BLOCK_DELIMITER = "--";
 
@@ -448,6 +450,10 @@ private static String rewriteLinks(String fileName,
             return "link:" + QUARKUS_IO_GUIDES_ATTRIBUTE + "/" + mr.group(1);
         });
 
+        content = ANCHOR_PATTERN.matcher(content).replaceAll(mr -> {
+            return "[[" + mr.group(1) + "]]";
+        });
+
         return content;
     }