examples/linked2.md in markdown_exec-1.3.9 vs examples/linked2.md in markdown_exec-1.4

@@ -1,28 +1,29 @@
 # Demo document linking
 
 ::: * This is document 2 *
 ::: This document links to a matching document to demonstrate navigation between documents.
 
-::: This Bash block displays the value of variables "linked1var" and "linked2var"
+::: This Bash block displays the value of variables "page1_var_via_environment" and "page2_var_via_environment"
 
-```bash :page2_show_vars
+```bash :show_vars
 source bin/colorize_env_vars.sh
-colorize_env_vars 'on page2' linked1var linked2var
+colorize_env_vars 'vars for page2' PAGE2_VAR_VIA_INHERIT page2_var_via_environment
+colorize_env_vars 'vars for page3' PAGE3_VAR_VIA_INHERIT page3_var_via_environment
 ```
 
-::: This Link block sets variable "linked1var" and navigates to document 1.
 
-```link :linked1
-file: examples/linked1.md
-vars:
-  linked1var: from_linked2
+::: This Link block requires a block that
+::: 1. sets environment variable PAGE3_VAR_VIA_INHERIT,
+::: 2. navigates to document 3, and
+::: 3. executes block "show_vars" to display the imported PAGE3_VAR_VIA_INHERIT.
+
+```bash :(vars3)
+PAGE3_VAR_VIA_INHERIT=for_page3_from_page2_via_inherited_code_file
 ```
 
-::: This Link block sets variable "linked1var", navigates to document 1, and executes block "page1_show_vars".
-
-```link :linked1_show_vars
-file: examples/linked1.md
-block: page1_show_vars
+```link :linked3_import_vars +(vars3)
+file: examples/linked3.md
+block: show_vars
 vars:
-  linked1var: from_linked2
+  page3_var_via_environment: for_page3_from_page2_via_current_environment
 ```