+{{/* Do **not** remove this comment! It ends above html block! See https://spec.commonmark.org/0.30/#html-blocks, 7. */}}
+{{ .Inner -}}
+
+
diff --git a/userguide/content/en/_index.html b/userguide/content/en/_index.html
index 835f233176..a0081afd37 100644
--- a/userguide/content/en/_index.html
+++ b/userguide/content/en/_index.html
@@ -15,7 +15,7 @@
{{< /blocks/cover >}}
-{{% blocks/lead color="primary" %}}
+{{< blocks/lead color="primary" >}}
Docsy is a theme for the Hugo static site generator that's specifically designed
for technical documentation sets. Our aim is to help you get a working
documentation site up and running as easily as possible, so you can concentrate
@@ -24,7 +24,7 @@
-{{% /blocks/lead %}}
+{{< /blocks/lead >}}
{{< blocks/section color="dark" type="features">}}
{{% blocks/feature icon="fa-lightbulb" title="See Docsy in action!" url="/docs/examples/" %}}
diff --git a/userguide/content/en/docs/adding-content/shortcodes/index.md b/userguide/content/en/docs/adding-content/shortcodes/index.md
index 2eda403c90..7d6e3e3b03 100644
--- a/userguide/content/en/docs/adding-content/shortcodes/index.md
+++ b/userguide/content/en/docs/adding-content/shortcodes/index.md
@@ -81,11 +81,12 @@ TechOS is the OS of the future.
Runs on **bare metal** in the **cloud**!
{{%/* /blocks/lead */%}}
```
+Use the syntax printed above if the inner content of your `/blocks/lead` shortcode is authored in markdown. In case of HTML content, use square brackets `<>` as innermost delimiters: `{{* blocks/lead >}}HTML content{{< /blocks/lead */>}}`.
-| Parameter | Default | Description |
-| ---------------- |------------| ------------|
-| height | | See above.
-| color | | See above.
+| Parameter | Default | Description |
+| --------- |--------- | ------------------------------- |
+| height | `auto` | [See above.](#shortcode-blocks) |
+| color | .Ordinal | [See above.](#shortcode-blocks) |
### blocks/section