diff --git a/pages/common/gh-gist.md b/pages/common/gh-gist.md
index 5d5ced94d5..b08fce493a 100644
--- a/pages/common/gh-gist.md
+++ b/pages/common/gh-gist.md
@@ -5,20 +5,20 @@
 
 - Create a new Gist from a space-separated list of files:
 
-`gh gist create {{path/to/files}}`
+`gh gist create {{path/to/file1 path/to/file2 ...}}`
 
-- Create a new Gist with a description:
+- Create a new Gist with a specific [desc]ription:
 
-`gh gist create {{path/to/file}} --desc "{{description}}"`
+`gh gist create {{path/to/file1 path/to/file2 ...}} --desc "{{description}}"`
 
 - Edit a Gist:
 
-`gh gist edit {{id_or_url}}`
+`gh gist edit {{id|url}}`
 
-- List Gists owned by the currently logged in user:
+- List up to 42 Gists owned by the currently logged in user:
 
-`gh gist list --limit {{int}}`
+`gh gist list --limit {{42}}`
 
 - View a Gist in the default browser without rendering Markdown:
 
-`gh gist view {{id_or_url}} --web --raw`
+`gh gist view {{id|url}} --web --raw`