take 5?

projects/hugo/hugo_shortcodes.md

@@ -16,19 +16,19 @@ Custom shortcodes defined in `layouts/shortcodes/`.
 *   **`include`**: Inject the contents of external files into your page. Supports local Hugo content paths and absolute paths mounted from the host (e.g., `/srv/configs/...`, `/srv/dev/hugo/wiki/...`).
 
     **CRITICAL: Angle Brackets (`< >`) vs. Percentage Signs (`% %`)**
-    *   Use **`&#123;&#123;% include ... %&#125;&#125;`** when you want the included text to be **parsed as Markdown**. This is required when including other `.md` files so their headers, lists, and links render properly.
-    *   Use **`&#123;&#123;< include ... >&#125;&#125;`** to output the raw text directly *without* Markdown processing.
+    *   Use **`{{%/* include ... */%}}`** when you want the included text to be **parsed as Markdown**. This is required when including other `.md` files so their headers, lists, and links render properly.
+    *   Use **`{{</* include ... */>}}`** to output the raw text directly *without* Markdown processing.
 
     **Example 1: Including another Markdown file**
     ```markdown
-    &#123;&#123;% include "/srv/dev/hugo/wiki/README.md" %&#125;&#125;
+    {{%/* include "/srv/dev/hugo/wiki/README.md" */%}}
     ```
 
     **Example 2: Including raw code into a Code Block**
     Wrap the shortcode in standard Markdown code fences to syntax-highlight an external configuration file:
     ````markdown
     ```yaml
-    &#123;&#123;% include "/srv/configs/docker_compose/homepage/docker-compose.yaml" %&#125;&#125;
+    {{%/* include "/srv/configs/docker_compose/homepage/docker-compose.yaml" */%}}
     ```
     ````
 *   **`video`**: Embed local or remote videos.