diff --git a/docs/docsite/rst/userguide/workflow_templates.rst b/docs/docsite/rst/userguide/workflow_templates.rst
index 21b784fd08f5..31fad625f92f 100644
--- a/docs/docsite/rst/userguide/workflow_templates.rst
+++ b/docs/docsite/rst/userguide/workflow_templates.rst
@@ -603,6 +603,8 @@ Extra Variables
    pair: workflow templates; survey extra variables
    pair: surveys; extra variables
 
+.. <- Comment to separate the index and the note to avoid rendering issues.
+
 .. note::
 
     ``extra_vars`` passed to the job launch API are only honored if one of the following is true: