diff --git a/markdown/dev/reference/api/macros/cutonfold/en.md b/markdown/dev/reference/api/macros/cutonfold/en.md
index 1e829b50b56..ccb545e1b35 100644
--- a/markdown/dev/reference/api/macros/cutonfold/en.md
+++ b/markdown/dev/reference/api/macros/cutonfold/en.md
@@ -12,7 +12,7 @@ macro('cutonfold', {
from: points.cofLeft,
to: points.cofRight,
grainline: true
-}
+})
```
| Property | Default | Type | Description |
diff --git a/markdown/dev/reference/api/macros/grainline/en.md b/markdown/dev/reference/api/macros/grainline/en.md
index 7e5ca53cf07..65c92a5a23a 100644
--- a/markdown/dev/reference/api/macros/grainline/en.md
+++ b/markdown/dev/reference/api/macros/grainline/en.md
@@ -11,7 +11,7 @@ It is provided by the [grainline plugin](/reference/plugins/grainline/).
macro("grainline", {
from: points.grainlineFrom,
to: points.grainlineTo,
-}
+})
```
| Property | Default | Type | Description |
diff --git a/markdown/dev/reference/api/macros/title/en.md b/markdown/dev/reference/api/macros/title/en.md
index 6a08506eac1..c569533209a 100644
--- a/markdown/dev/reference/api/macros/title/en.md
+++ b/markdown/dev/reference/api/macros/title/en.md
@@ -5,7 +5,7 @@ title: title
The `title` macro adds a title to a pattern part.
It is provided by the [title plugin](/reference/plugins/title).
-
+Example of a title added by this macro
| Property | Default | Type | Description |
| ----------:| :-----: | ---------------------------------------------------------- |
diff --git a/markdown/dev/reference/api/macros/vd/en.md b/markdown/dev/reference/api/macros/vd/en.md
index a815c62e093..92460a12730 100644
--- a/markdown/dev/reference/api/macros/vd/en.md
+++ b/markdown/dev/reference/api/macros/vd/en.md
@@ -5,10 +5,9 @@ title: vd
The `vd` macro adds a *vertical dimension* to your pattern.
It is provided by the [dimension plugin](/reference/plugins/dimension/).
-
+
+An example of a vertical dimension
+
```js
macro('vd', {