diff --git a/docs/samples/generic_plot.kibot.yaml b/docs/samples/generic_plot.kibot.yaml
index 209fd8d3..5585661f 100644
--- a/docs/samples/generic_plot.kibot.yaml
+++ b/docs/samples/generic_plot.kibot.yaml
@@ -74,7 +74,7 @@ preflight:
         before: 'Git hash: <'
         after: '>'
   # [dict|list(dict)] Defines KiCad 6+ variables.
-  # They are expanded using ${VARIABLE}, and stored in the project file.
+  # They are expanded using `${VARIABLE}`, and stored in the project file.
   # This preflight replaces `pcb_replace` and `sch_replace` when using KiCad 6.
   # The KiCad project file is modified.
   # Warning: don't use `-s all` or this preflight will be skipped.
@@ -821,7 +821,7 @@ outputs:
       # [boolean=true] Instead of download things we already downloaded use symlinks
       link_repeated: true
       # [string='${VALUE}.pdf'] Name used for the downloaded datasheet.
-      # ${FIELD} will be replaced by the FIELD content
+      # `${FIELD}` will be replaced by the FIELD content
       output: '${VALUE}.pdf'
       # [string|list(string)='_none'] Name of the filter to transform fields before applying other filters.
       # A short-cut to use for simple cases where a variant is an overkill
@@ -841,8 +841,8 @@ outputs:
     options:
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'
@@ -1069,8 +1069,8 @@ outputs:
       create_gerber_job_file: true
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'
@@ -1145,8 +1145,8 @@ outputs:
     options:
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'
@@ -1923,7 +1923,7 @@ outputs:
             tly: 0
             # [number|string] Extra space around the PCB reported size to be included. Used for *auto* and *annotation*
             tolerance: 1
-            # [string='auto'] [auto,rectangle,annotation] How we select the area of the PCB tu used for the panelization.
+            # [string='auto'] [auto,rectangle,annotation] How we select the area of the PCB used for the panelization.
             # *auto* uses all the area reported by KiCad, *rectangle* a specified rectangle and
             # *annotation* selects a contour marked by a kikit:Board footprint
             type: 'auto'
@@ -2554,8 +2554,8 @@ outputs:
     options:
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'
@@ -2819,8 +2819,8 @@ outputs:
       a4_output: true
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'
@@ -3303,8 +3303,8 @@ outputs:
     options:
       # [list(dict)] A list of customized reports for the manufacturer
       custom_reports:
-        # [string=''] Content for the report. Use ${basename} for the project name without extension.
-        # Use ${filename(LAYER)} for the file corresponding to LAYER
+        # [string=''] Content for the report. Use `${basename}` for the project name without extension.
+        # Use `${filename(LAYER)}` for the file corresponding to LAYER
         - content: ''
           # [string='Custom_report.txt'] File name for the custom report
           output: 'Custom_report.txt'