diff --git a/docs/syntax/markdown.md b/docs/syntax/markdown.md
index b877bb05a..dd8569281 100644
--- a/docs/syntax/markdown.md
+++ b/docs/syntax/markdown.md
@@ -158,12 +158,12 @@ You can create fenced code blocks by placing triple backticks ` ``` ` before and
     }
     ```
 
-If your code contains templating syntax such as `{{ this }}` (see [templating](/docs/templating/variables.md)), you can disable templating with a `{% raw %}` block:
+If your code contains templating syntax such as `{{ this }}` (see [templating](/docs/templating/variables.md)), you can disable templating with a `raw` block:
 
 {% raw %}
     {% raw %}
-    ```
-    <span>{{this will not be interpreted as templating}}</span>
+    ```html
+    <span>{{ this will not be interpreted as templating }}</span>
     ```
     {% endraw %}
 {% endraw %}