diff --git a/pages/common/pulumi-about.md b/pages/common/pulumi-about.md
index f4d3f3eb4d..29fc58478b 100644
--- a/pages/common/pulumi-about.md
+++ b/pages/common/pulumi-about.md
@@ -9,12 +9,12 @@
 
 - Print information about the Pulumi environment in JSON format:
 
-`pulumi about --json`
+`pulumi about {{[-j|--json]}}`
 
 - Print information about the Pulumi environment of a specific stack:
 
-`pulumi about --stack {{stack_name}}`
+`pulumi about {{[-s|--stack]}} {{stack_name}}`
 
 - Display help:
 
-`pulumi about --help`
+`pulumi about {{[-h|--help]}}`
diff --git a/pages/common/pulumi-cancel.md b/pages/common/pulumi-cancel.md
index 017e595182..cba9019fd7 100644
--- a/pages/common/pulumi-cancel.md
+++ b/pages/common/pulumi-cancel.md
@@ -9,8 +9,8 @@
 
 - Skip confirmation prompts, and proceed with cancellation anyway:
 
-`pulumi cancel --yes`
+`pulumi cancel {{[-y|--yes]}}`
 
 - Display help:
 
-`pulumi cancel --help`
+`pulumi cancel {{[-h|--help]}}`
diff --git a/pages/common/pulumi-config.md b/pages/common/pulumi-config.md
index 961c077fe5..cadf3e51c7 100644
--- a/pages/common/pulumi-config.md
+++ b/pages/common/pulumi-config.md
@@ -5,11 +5,11 @@
 
 - View current configuration in JSON format:
 
-`pulumi config --json`
+`pulumi config {{[-j|--json]}}`
 
 - View configuration for a specified stack:
 
-`pulumi config --stack {{stack_name}}`
+`pulumi config {{[-s|--stack]}} {{stack_name}}`
 
 - Get the value of a configuration key:
 
diff --git a/pages/common/pulumi-destroy.md b/pages/common/pulumi-destroy.md
index 9b16843894..01d0c974ed 100644
--- a/pages/common/pulumi-destroy.md
+++ b/pages/common/pulumi-destroy.md
@@ -9,11 +9,11 @@
 
 - Destroy all resources in a specific stack:
 
-`pulumi destroy --stack {{stack}}`
+`pulumi destroy {{[-s|--stack]}} {{stack}}`
 
 - Automatically approve and destroy resources after previewing:
 
-`pulumi destroy --yes`
+`pulumi destroy {{[-y|--yes]}}`
 
 - Exclude protected resources from being destroyed:
 
diff --git a/pages/common/pulumi-env.md b/pages/common/pulumi-env.md
index 8d4440f11c..9b9d48915b 100644
--- a/pages/common/pulumi-env.md
+++ b/pages/common/pulumi-env.md
@@ -29,4 +29,4 @@
 
 - Display help:
 
-`pulumi env --help`
+`pulumi env {{[-h|--help]}}`
diff --git a/pages/common/pulumi-new.md b/pages/common/pulumi-new.md
index 71afc26a02..43f526ccb5 100644
--- a/pages/common/pulumi-new.md
+++ b/pages/common/pulumi-new.md
@@ -21,4 +21,4 @@
 
 - Use the specified secrets provider with the <pulumi.com> backend:
 
-`pulumi new --secrets-provider={{passphrase}}`
+`pulumi new --secrets-provider {{passphrase}}`
diff --git a/pages/common/pulumi-preview.md b/pages/common/pulumi-preview.md
index 1f1fd22c43..d81c00f017 100644
--- a/pages/common/pulumi-preview.md
+++ b/pages/common/pulumi-preview.md
@@ -9,7 +9,7 @@
 
 - Show a preview of updates to a stack's resources in JSON format:
 
-`pulumi preview --json`
+`pulumi preview {{[-j|--json]}}`
 
 - Preview updates as a rich diff showing overall changes:
 
@@ -17,4 +17,4 @@
 
 - Display help:
 
-`pulumi preview --help`
+`pulumi preview {{[-h|--help]}}`
diff --git a/pages/common/pulumi-refresh.md b/pages/common/pulumi-refresh.md
index 8426650fa0..054355ba0e 100644
--- a/pages/common/pulumi-refresh.md
+++ b/pages/common/pulumi-refresh.md
@@ -21,8 +21,8 @@
 
 - The name of the stack to operate on (defaults to the current stack):
 
-`pulumi refresh --stack {{stack_name}}`
+`pulumi refresh {{[-s|--stack]}} {{stack_name}}`
 
 - Display help:
 
-`pulumi refresh --help`
+`pulumi refresh {{[-h|--help]}}`
diff --git a/pages/common/pulumi-stack.md b/pages/common/pulumi-stack.md
index 1e29b11aaa..99fbe4d3c8 100644
--- a/pages/common/pulumi-stack.md
+++ b/pages/common/pulumi-stack.md
@@ -9,7 +9,7 @@
 
 - Show the stack state along with resource URNs:
 
-`pulumi stack --show-urns`
+`pulumi stack {{[-u|--show-urns]}}`
 
 - List stacks in the current project:
 
@@ -17,7 +17,7 @@
 
 - List stacks across all projects:
 
-`pulumi stack ls --all`
+`pulumi stack ls {{[-a|--all]}}`
 
 - Select an active stack:
 
diff --git a/pages/common/pulumi-state.md b/pages/common/pulumi-state.md
index 7014b59010..da879a19ff 100644
--- a/pages/common/pulumi-state.md
+++ b/pages/common/pulumi-state.md
@@ -25,4 +25,4 @@
 
 - Display help:
 
-`pulumi state --help`
+`pulumi state {{[-h|--help]}}`
diff --git a/pages/common/pulumi-up.md b/pages/common/pulumi-up.md
index 4b0a949e9a..2b34e10d9f 100644
--- a/pages/common/pulumi-up.md
+++ b/pages/common/pulumi-up.md
@@ -9,11 +9,11 @@
 
 - Automatically approve and perform the update after previewing it:
 
-`pulumi up --yes`
+`pulumi up {{[-y|--yes]}}`
 
 - Preview and deploy changes in a specific stack:
 
-`pulumi up --stack {{stack}}`
+`pulumi up {{[-s|--stack]}} {{stack}}`
 
 - Don't display stack outputs: