diff --git a/src/doc/macros.rst b/src/doc/macros.rst
index 3d995c1fbc67b155a6df606ac2f84a0cec26d1a5..569b8474c98ff8f5f5a4f2eeface10ffc1b7a849 100644
--- a/src/doc/macros.rst
+++ b/src/doc/macros.rst
@@ -37,7 +37,7 @@ The same version using cfood macros could be defined as follows:
         name: null
         filename: null
       definition:
-        ${name}_filename
+        ${name}_filename:
           type: SimpleFile
           match: $filename
           records:
@@ -57,6 +57,8 @@ The same version using cfood macros could be defined as follows:
         filename: ^README.md$
 
 
+The "MarkdownFile" key and its value will be replaced by everything that is 
+given below "definition" in the Macro.