diff --git a/content/en/docs/zero-code/java/agent/configuration.md b/content/en/docs/zero-code/java/agent/configuration.md
index ac75cd828e9b..2796cfcd5ea0 100644
--- a/content/en/docs/zero-code/java/agent/configuration.md
+++ b/content/en/docs/zero-code/java/agent/configuration.md
@@ -123,7 +123,7 @@ is the name of a remote service to which a connection is made. It corresponds to
 `service.name` in the [resource](/docs/specs/semconv/resource/#service) for the
 local service.
 
-{{% config_option name="otel.instrumentation.common.peer-service-mapping" %}}
+{{< config_option name="otel.instrumentation.common.peer-service-mapping" >}}
 
 Used to specify a mapping from host names or IP addresses to peer services, as a
 comma-separated list of `<host_or_ip>=<user_assigned_name>` pairs. The peer
@@ -150,7 +150,7 @@ while `1.2.3.4:443` will have have `peer.service` of `cats-service` and requests
 to `dogs-abcdef123.serverlessapis.com:80/api/v1` will have an attribute of
 `dogs-api`.
 
-{{% /config_option %}}
+{{< /config_option >}}
 
 ### DB statement sanitization
 
diff --git a/layouts/shortcodes/config_option.html b/layouts/shortcodes/config_option.html
index 31c847bdde09..d61a945e849c 100644
--- a/layouts/shortcodes/config_option.html
+++ b/layouts/shortcodes/config_option.html
@@ -16,5 +16,5 @@
   <span class="label">Default</span>: {{ .Get "default" }}<br>
 {{ end -}}
 <span class="label">Description</span>:
-{{ trim .InnerDeindent "\n " }}
+{{ trim .InnerDeindent "\n " | markdownify }}
 </div>