diff --git a/README.md b/README.md
index d24b3e2c..d388eb55 100644
--- a/README.md
+++ b/README.md
@@ -520,7 +520,7 @@ Parameters:
 
 <dl>
     <dt><code>caption</code></dt>
-    <dd>Optional. Descriptive text that appears centered below the images. Markdown.</dd>
+    <dd>Optional. First unnamed argument. Descriptive text that appears centered below the images. Markdown.</dd>
 </dl>
 
 ### Quote
@@ -541,7 +541,7 @@ Parameters:
     <dt><code>caption</code></dt>
     <dd>Optional. Descriptive text that appears centered below the images. Markdown. Must not be used with <code>cite</code>.</dd>
     <dt><code>cite</code></dt>
-    <dd>Optional. Markdown. Must not be used with <code>caption</code>.</dd>
+    <dd>Optional. First unnamed argument. Markdown. Must not be used with <code>caption</code>.</dd>
 </dl>
 
 ### Code
@@ -567,7 +567,7 @@ Parameters:
     <dt><code>caption</code></dt>
     <dd>Optional. Descriptive text that appears centered below the images. Markdown.</dd>
     <dt><code>lang</code></dt>
-    <dd>Required. <a href="https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages">Chroma language code</a>.</dd>
+    <dd>Required. First unnamed argument. Chroma language code. See <a href="https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages">available codes</a>.</dd>
     <dt><code>options</code></dt>
     <dd>Optional. <a href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode">Hugo highlight options</a>.</dd>
 </dl>
@@ -599,7 +599,7 @@ Parameters:
     <dt><code>title</code></dt>
     <dd>Optional. Plain text. Image title.</dd>
     <dt><code>src</code></dt>
-    <dd>Required. URL. Image URL.</dd>
+    <dd>Required. First unnamed argument. URL. Image URL.</dd>
 </dl>
 
 ```
@@ -644,7 +644,7 @@ Parameters:
     <dt><code>image</code></dt>
     <dd>Optional. Page, site, or remote image glob. Only used in the inner content of this shortcode.</dd>
     <dt><code>images</code></dt>
-    <dd>Optional. Page, site, or remote images glob. Defaults to all image page resources.</dd>
+    <dd>Optional. First unnamed argument. Page, site, or remote images glob. Defaults to all image page resources.</dd>
     <dt><code>justify</code></dt>
     <dd>Optional. Flexbox main axis space distribution. Must be <code>start</code>, <code>center</code>, <code>end</code>, etc. See <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content"><code>justify-content</code></a>.</dd>
     <dt><code>method</code></dt>