diff --git a/docs/source/markdown/options/secret.md b/docs/source/markdown/options/secret.md
index cd9a6a6e9d..477d9329d2 100644
--- a/docs/source/markdown/options/secret.md
+++ b/docs/source/markdown/options/secret.md
@@ -37,10 +37,16 @@ Secret Options
 Examples
 
 Mount at `/my/location/mysecret` with UID 1.
-```--secret mysecret,target=/my/location/mysecret,uid=1```
+```
+--secret mysecret,target=/my/location/mysecret,uid=1
+```
 
 Mount at `/run/secrets/customtarget` with mode 0777.
-```--secret mysecret,target=customtarget,mode=0777```
+```
+--secret mysecret,target=customtarget,mode=0777
+```
 
 Create a secret environment variable called `ENVSEC`.
-```--secret mysecret,type=env,target=ENVSEC```
+```
+--secret mysecret,type=env,target=ENVSEC
+```