diff --git a/docs/source/markdown/podman-system-connection-add.1.md b/docs/source/markdown/podman-system-connection-add.1.md
index 5ac265d098..2e50d21ad2 100644
--- a/docs/source/markdown/podman-system-connection-add.1.md
+++ b/docs/source/markdown/podman-system-connection-add.1.md
@@ -36,13 +36,24 @@ Port for ssh destination. The default value is `22`.
 Path to the Podman service unix domain socket on the ssh destination host
 
 ## EXAMPLE
+
+Add a named system connection:
 ```
 $ podman system connection add QA podman.example.com
+```
 
+Add a system connection using SSH data:
+```
 $ podman system connection add --identity ~/.ssh/dev_rsa production ssh://root@server.example.com:2222
+```
 
+Add a named system connection to local Unix domain socket:
+```
 $ podman system connection add testing unix:///run/podman/podman.sock
+```
 
+Add a named system connection to local tcp socket:
+```
 $ podman system connection add debug tcp://localhost:8080
 ```
 ## SEE ALSO
diff --git a/docs/source/markdown/podman-system-connection-default.1.md b/docs/source/markdown/podman-system-connection-default.1.md
index 574625cef2..465801a5d3 100644
--- a/docs/source/markdown/podman-system-connection-default.1.md
+++ b/docs/source/markdown/podman-system-connection-default.1.md
@@ -10,6 +10,8 @@ podman\-system\-connection\-default - Set named destination as default for the P
 Set named ssh destination as default destination for the Podman service.
 
 ## EXAMPLE
+
+Set the specified connection as default:
 ```
 $ podman system connection default production
 ```
diff --git a/docs/source/markdown/podman-system-connection-list.1.md b/docs/source/markdown/podman-system-connection-list.1.md
index edd2372122..ed0e94acd1 100644
--- a/docs/source/markdown/podman-system-connection-list.1.md
+++ b/docs/source/markdown/podman-system-connection-list.1.md
@@ -31,6 +31,8 @@ Valid placeholders for the Go template listed below:
 Only show connection names
 
 ## EXAMPLE
+
+List system connections:
 ```
 $ podman system connection list
 Name URI                                                      Identity	    Default  ReadWrite
diff --git a/docs/source/markdown/podman-system-connection-remove.1.md b/docs/source/markdown/podman-system-connection-remove.1.md
index 45fede0215..ad351e9296 100644
--- a/docs/source/markdown/podman-system-connection-remove.1.md
+++ b/docs/source/markdown/podman-system-connection-remove.1.md
@@ -16,6 +16,8 @@ Delete named ssh destination.
 Remove all connections.
 
 ## EXAMPLE
+
+Remove the specified system connection:
 ```
 $ podman system connection remove production
 ```
diff --git a/docs/source/markdown/podman-system-connection-rename.1.md b/docs/source/markdown/podman-system-connection-rename.1.md
index ed10c1cd6f..296abdbde0 100644
--- a/docs/source/markdown/podman-system-connection-rename.1.md
+++ b/docs/source/markdown/podman-system-connection-rename.1.md
@@ -10,6 +10,8 @@ podman\-system\-connection\-rename - Rename the destination for Podman service
 Rename ssh destination from *old* to *new*.
 
 ## EXAMPLE
+
+Rename the specified connection:
 ```
 $ podman system connection rename laptop devel
 ```
diff --git a/docs/source/markdown/podman-system-connection.1.md b/docs/source/markdown/podman-system-connection.1.md
index f126d3b116..c76985b9bf 100644
--- a/docs/source/markdown/podman-system-connection.1.md
+++ b/docs/source/markdown/podman-system-connection.1.md
@@ -33,6 +33,8 @@ not be edited with the **podman system connection** commands.
 | rename   | [podman-system-connection\-rename(1)](podman-system-connection-rename.1.md)   | Rename the destination for Podman service                  |
 
 ## EXAMPLE
+
+List system connections:
 ```
 $ podman system connection list
 Name URI                                           Identity	      Default  ReadWrite
diff --git a/docs/source/markdown/podman-system-df.1.md b/docs/source/markdown/podman-system-df.1.md
index 8b8e779841..a2dc5c6f39 100644
--- a/docs/source/markdown/podman-system-df.1.md
+++ b/docs/source/markdown/podman-system-df.1.md
@@ -31,13 +31,18 @@ Valid placeholders for the Go template are listed below:
 Show detailed information on space usage
 
 ## EXAMPLE
+
+Show disk usage:
 ```
 $ podman system df
 TYPE            TOTAL   ACTIVE   SIZE    RECLAIMABLE
 Images          6       2        281MB   168MB (59%)
 Containers      3       1        0B      0B (0%)
 Local Volumes   1       1        22B     0B (0%)
+```
 
+Show disk usage in verbose mode:
+```
 $ podman system df -v
 Images space usage: