markdown_exec 2.3.0 → 2.4.0

data/bats/test_helper.bash

@@ -0,0 +1,152 @@
+# facilitate execution of program, comparison of output
+
+export PROJECT_ROOT="/Users/fareed/Documents/dev/ruby/markdown_exec"
+
+date_from_history_file_name () {
+  basename "$1" | sed -E 's/.*([0-9]{4}-[0-9]{2}-[0-9]{2}).*/\1/'
+}
+
+echo_hexdump () {
+  echo -en "$1" | hexdump -C
+}
+
+exec_mde () {
+  echo "bin/bmde "$1" "${@:2}""
+  run bin/bmde "$1" ${@:2}
+}
+
+expect_equal_with_conversion () {
+  local expected="$1"
+  local actual="$2"
+  if [[ $3 == A ]]; then
+    actual="$(remove_ansi_escape_sequences "$2")"
+    # echo "- expected"
+    # echo "$expected" | hexdump -C
+    # echo "- actual"
+    # echo "$actual" | hexdump -C
+  fi
+  [[ "$expected" == "$actual" ]]
+}
+
+most_recent_history_file_name () {
+  ls -f logs/*examples_save_md* | tail -n 1
+}
+
+# remove_ansi_escape_sequences
+#
+# A function to process a string by removing ANSI escape sequences and replacing
+# newlines with spaces. This is particularly useful when dealing with formatted
+# text output that includes color codes or other terminal formatting and needs
+# to be sanitized for plain text processing.
+#
+# Parameters:
+#   $1 (string): The input string that may contain ANSI escape sequences and/or
+#                various whitespace characters (newlines, tabs, etc.).
+#
+# Returns:
+#   The processed string with ANSI escape sequences removed and all specified
+#   whitespace characters replaced by spaces.
+#
+# Example:
+#   input="Hello \e[31mWorld\e[0m\nThis\tis\ra test.\vPage\fBreak"
+#   result=$(remove_ansi_escape_sequences "$input")
+#   echo "$result"
+#   # Output: "Hello World This is a test. Page Break"
+#
+# Note:
+#   - The function does not modify the original input string but returns a new
+#     processed string.
+#   - ANSI escape sequences are sequences used to control formatting, color, and
+#     other output options on text terminals.
+#   - The following whitespace characters are replaced with spaces: newlines (\n),
+#     tabs (\t), carriage returns (\r), vertical tabs (\v), and form feeds (\f).
+#
+remove_ansi_escape_sequences() {
+  echo -en "$1" | perl -pe 's/\e\[\?*[0-9;]*[a-zA-Z]//g' | tr '\n\t\r\v\f' ' '
+}
+
+run_mde_specs_md_args_expect_xansi () {
+  expected="${!#}"
+  exec_mde docs/dev/specs.md ${@:1:$#-1}
+
+  filter="${BATS_OUTPUT_FILTER:-A}"
+  if ( ! expect_equal_with_conversion "$expected" "$output" "$filter" ); then
+    echo -e "- command: ${@:1:$#-1}"
+    echo -e "- expected:\n$expected"
+    echo_hexdump "$expected"
+    echo -e "- output:\n$(text_filter_ansi "$output" "$filter")"
+    echo_hexdump "$output"
+  fi
+
+  expect_equal_with_conversion "$expected" "$output" "$filter"
+  (( $status != $0 )) && echo "- status: $status"
+  [ "$status" -eq 0 ]
+}
+
+spec_mde_args_expect () {
+  # while :; do
+  #   SHIFT_COUNT=2
+  #   case "$1" in
+  #     --ansver)   RANSVER="$2"   ;;
+  #     --auto)     TTY=""        ; SHIFT_COUNT=1 ;;
+  #     *) break ;;
+  #   esac
+  #   shift "$SHIFT_COUNT"
+  # done
+  spec_mde_args_grep_filter_expect ${@:1:$#-1} "$BATS_OUTPUT_GREP" "$BATS_OUTPUT_FILTER" "${@: -1}"
+}
+
+spec_mde_args_grep_filter_expect () {
+  local remaining="${@:1:$(($#-3))}"
+  local pattern="${@: -3:1}"
+  local filter="${@: -2:1}"
+  local expected="${@: -1}"
+  SL="${BATS_SLEEP}"
+  local STATUS="${BATS_STATUS:-0}"
+
+  if [[ -z $SL ]]; then
+    # echo bin/bmde "$remaining"
+    run bin/bmde $remaining
+  else
+    bash -c "
+      SL=$SL
+      bin/bmde $remaining >/tmp/mde.out &"'
+      app_pid=$!
+      sleep $SL
+      kill $app_pid && wait $app_pid 2>/dev/null
+      ls -al /tmp/mde.out
+      # cat /tmp/mde.out
+      :'
+    output="$(cat /tmp/mde.out)"
+    rm /tmp/mde.out
+  fi
+  local output0="$output"
+  if [[ -n $pattern ]]; then
+    # prevent error from grep
+    output="$(echo -en "$output" | grep "$pattern")" || :
+  fi
+
+  if ( ! expect_equal_with_conversion "$expected" "$output" "$filter"); then
+    echo -e "- output_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):\n$output"
+    [[ $filter == A ]] && echo_hexdump "$output"
+
+    if [[ $filter == A ]]; then
+      echo -e "- converted_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):"
+      echo "$(remove_ansi_escape_sequences "$output")"
+      echo_hexdump "$(remove_ansi_escape_sequences "$output")"
+    fi
+    echo -e "- expected_$(echo "$expected" | wc -l)_$(echo -n "$expected" | wc -c):\n$expected"
+    [[ $filter == A ]] && echo_hexdump "$expected"
+  fi
+  expect_equal_with_conversion "$expected" "$output" "$filter"
+  (( $status != $STATUS )) && echo "- status: $status"
+  [ "$status" -eq $STATUS ]
+}
+
+text_filter_ansi () {
+  if [[ $# -eq 2 ]]; then
+    remove_ansi_escape_sequences "$1"
+  else
+    echo -n "$1"
+  fi
+}

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.3.0"
+  echo "2.4.0"
 }
 
 _mde() {
@@ -32,27 +32,29 @@ _mde() {
         
               --config) COMPREPLY="."; return 0 ;;
             
-              --debug) COMPREPLY="0"; return 0 ;;
+              --debug) COMPREPLY="f"; return 0 ;;
             
-              -d) COMPREPLY="0"; return 0 ;;
+              -d) COMPREPLY="f"; return 0 ;;
             
-              --dump-delegate-object) COMPREPLY="0"; return 0 ;;
+              --dump-blocks-in-file) COMPREPLY="f"; return 0 ;;
             
-              --dump-blocks-in-file) COMPREPLY="0"; return 0 ;;
+              --dump-delegate-object) COMPREPLY="f"; return 0 ;;
             
-              --dump-inherited-block_names) COMPREPLY="0"; return 0 ;;
+              --dump-dependencies) COMPREPLY="f"; return 0 ;;
             
-              --dump-inherited-dependencies) COMPREPLY="0"; return 0 ;;
+              --dump-inherited-block-names) COMPREPLY="f"; return 0 ;;
             
-              --dump-inherited-lines) COMPREPLY="0"; return 0 ;;
+              --dump-inherited-dependencies) COMPREPLY="f"; return 0 ;;
             
-              --dump-menu-blocks) COMPREPLY="0"; return 0 ;;
+              --dump-inherited-lines) COMPREPLY="f"; return 0 ;;
             
-              --dump-selected-block) COMPREPLY="0"; return 0 ;;
+              --dump-menu-blocks) COMPREPLY="f"; return 0 ;;
             
-              --execute_in_own_window) COMPREPLY="0"; return 0 ;;
+              --dump-selected-block) COMPREPLY="f"; return 0 ;;
             
-              -w) COMPREPLY="0"; return 0 ;;
+              --execute-in-own-window) COMPREPLY="f"; return 0 ;;
+            
+              -w) COMPREPLY="f"; return 0 ;;
             
               --filename) COMPREPLY="."; return 0 ;;
             
@@ -68,8 +70,16 @@ _mde() {
             
               -?) COMPREPLY="''"; return 0 ;;
             
+              --list-blocks-eval) COMPREPLY="''"; return 0 ;;
+            
+              --list-blocks-message) COMPREPLY="oname"; return 0 ;;
+            
+              --list-blocks-type) COMPREPLY="0"; return 0 ;;
+            
               --list-count) COMPREPLY="32"; return 0 ;;
             
+              --format) COMPREPLY="text"; return 0 ;;
+            
               --load-code) COMPREPLY="''"; return 0 ;;
             
               -l) COMPREPLY="''"; return 0 ;;
@@ -78,17 +88,19 @@ _mde() {
             
               -o) COMPREPLY="''"; return 0 ;;
             
-              --output-script) COMPREPLY="0"; return 0 ;;
+              --output-script) COMPREPLY="f"; return 0 ;;
             
-              --output-stdout) COMPREPLY="1"; return 0 ;;
+              --output-stdout) COMPREPLY="t"; return 0 ;;
             
               --path) COMPREPLY="."; return 0 ;;
             
               -p) COMPREPLY="."; return 0 ;;
             
-              --user-must-approve) COMPREPLY="0"; return 0 ;;
+              --pause-after-script-execution) COMPREPLY="f"; return 0 ;;
+            
+              --user-must-approve) COMPREPLY="f"; return 0 ;;
             
-              -q) COMPREPLY="0"; return 0 ;;
+              -q) COMPREPLY="f"; return 0 ;;
             
               --display-level) COMPREPLY="1"; return 0 ;;
             
@@ -100,7 +112,7 @@ _mde() {
   # present matching option names
   #
   if [[ ${cur} == -* ]] ; then
-    opts=("--block-name" "--config" "--debug" "--dump-delegate-object" "--dump-blocks-in-file" "--dump-inherited-block_names" "--dump-inherited-dependencies" "--dump-inherited-lines" "--dump-menu-blocks" "--dump-selected-block" "--execute_in_own_window" "--exit" "--filename" "--find" "--find-path" "--help" "--how" "--list-blocks" "--list-count" "--list-default-env" "--list-default-yaml" "--list-docs" "--list-recent-output" "--list-recent-scripts" "--load-code" "--open" "--output-script" "--output-stdout" "--path" "--pwd" "--run-last-script" "--tab-completions" "--user-must-approve" "--version" "--display-level")
+    opts=("--block-name" "--config" "--debug" "--dig" "--dump-blocks-in-file" "--dump-delegate-object" "--dump-dependencies" "--dump-inherited-block-names" "--dump-inherited-dependencies" "--dump-inherited-lines" "--dump-menu-blocks" "--dump-selected-block" "--execute-in-own-window" "--exit" "--filename" "--find" "--find-path" "--help" "--history" "--how" "--list-blocks" "--list-blocks-eval" "--list-blocks-message" "--list-blocks-type" "--list-count" "--list-default-env" "--list-default-yaml" "--list-docs" "--format" "--list-recent-output" "--list-recent-scripts" "--load-code" "--mine" "--open" "--output-script" "--output-stdout" "--path" "--pause-after-script-execution" "--probe" "--publish-document-file-mode" "--publish-document-file-name" "--pwd" "--run-last-script" "--sift" "--tab-completions" "--user-must-approve" "--version" "--display-level")
     COMPREPLY=( $(compgen -W "$(printf "'%s' " "${opts[@]}")" -- "${cur}") )
 
     return 0
@@ -123,11 +135,13 @@ _mde() {
         
           -d) COMPREPLY=".BOOL."; return 0 ;;
         
+          --dump-blocks-in-file) COMPREPLY=".BOOL."; return 0 ;;
+        
           --dump-delegate-object) COMPREPLY=".BOOL."; return 0 ;;
         
-          --dump-blocks-in-file) COMPREPLY=".BOOL."; return 0 ;;
+          --dump-dependencies) COMPREPLY=".BOOL."; return 0 ;;
         
-          --dump-inherited-block_names) COMPREPLY=".BOOL."; return 0 ;;
+          --dump-inherited-block-names) COMPREPLY=".BOOL."; return 0 ;;
         
           --dump-inherited-dependencies) COMPREPLY=".BOOL."; return 0 ;;
         
@@ -137,7 +151,7 @@ _mde() {
         
           --dump-selected-block) COMPREPLY=".BOOL."; return 0 ;;
         
-          --execute_in_own_window) COMPREPLY=".BOOL."; return 0 ;;
+          --execute-in-own-window) COMPREPLY=".BOOL."; return 0 ;;
         
           -w) COMPREPLY=".BOOL."; return 0 ;;
         
@@ -155,8 +169,16 @@ _mde() {
         
           -?) COMPREPLY=".HOW."; return 0 ;;
         
+          --list-blocks-eval) COMPREPLY=".EVAL."; return 0 ;;
+        
+          --list-blocks-message) COMPREPLY=".MESSAGE."; return 0 ;;
+        
+          --list-blocks-type) COMPREPLY=".TYPE."; return 0 ;;
+        
           --list-count) COMPREPLY=".INT.1-."; return 0 ;;
         
+          --format) COMPREPLY=".FORMAT."; return 0 ;;
+        
           --load-code) COMPREPLY=".PATH."; return 0 ;;
         
           -l) COMPREPLY=".PATH."; return 0 ;;
@@ -173,6 +195,8 @@ _mde() {
         
           -p) COMPREPLY=".RELATIVE_PATH."; return 0 ;;
         
+          --pause-after-script-execution) COMPREPLY=".BOOL."; return 0 ;;
+        
           --user-must-approve) COMPREPLY=".BOOL."; return 0 ;;
         
           -q) COMPREPLY=".BOOL."; return 0 ;;

data/docs/dev/block-type-opts.md

@@ -0,0 +1,10 @@
+Species
+```opts :[decorate-note]
+menu_note_format: "AFTER %{line}"
+```
+@import bats-document-configuration.md
+```opts :(document_options)
+menu_divider_format:
+menu_note_format: "BEFORE %{line}"
+menu_with_exit: false
+```

data/docs/dev/block-type-port.md

@@ -0,0 +1,24 @@
+```vars :[set_vault_1]
+VAULT: 1
+```
+
+::: This is a Port block that saves current/live environment variable values into the generated script.
+
+```port :[vault]
+VAULT
+```
+
+```bash :VAULT-is-export
+exported_vault=$(export -p | grep '^declare -x VAULT')
+# (No output, var is not exported)
+```
+
+::: This block requires the Port block and displays the value.
+::: The Port block contributes the variable VAULT to the generated script.
+
+```bash :show +[set_vault_1] +[vault]
+: ${VAULT:=This variable has not been set.}
+echo "VAULT: $VAULT"
+```
+
+@import bats-document-configuration.md

data/docs/dev/block-type-vars.md

@@ -0,0 +1,7 @@
+```vars :[set_vault_1]
+VAULT: 1
+```
+```bash :show
+echo "VAULT: $VAULT"
+```
+@import bats-document-configuration.md

data/docs/dev/pass-through-arguments.md

@@ -0,0 +1,8 @@
+This block will output any command line arguments after "--".
+```bash :output_arguments
+echo "ARGS: $*"
+```
+```link :[ok]
+block: output_arguments
+```
+@import bats-document-configuration.md

data/docs/dev/specs-import.md

@@ -0,0 +1,9 @@
+```bash :shell-block-in-import
+echo shell-block-in-import
+```
+```bash :{wrap-from-import}
+echo "wrap-from-import-before"
+```
+```bash :{wrap-from-import-after}
+echo "wrap-from-import-after"
+```

data/docs/dev/specs.md

@@ -0,0 +1,83 @@
+# Automated tests
+
+## Shell blocks
+
+```bash :bash1
+echo "bash1!"
+```
+
+## Link Vars
+
+| inputs to MDE| expected output
+| -| -
+| '[VARIABLE1]'| ' VARIABLE1: 1'
+| '[VARIABLE1]' '(echo-VARIABLE1)'| ' VARIABLE1: 1   VARIABLE1: 1'
+
+```bash :(echo-VARIABLE1)
+for var_name in "VARIABLE1"; do
+  # echo -e "\033[0;33m${var_name}\033[0;31m:\033[0m ${!var_name}"
+  echo -e "${var_name}: ${!var_name}"
+done
+```
+```link :[VARIABLE1]
+block: (echo-VARIABLE1)
+vars:
+  VARIABLE1: 1
+```
+
+## Nested wraps
+
+| inputs to MDE| expected output
+| -| -
+| '[single]'| ' single-body'
+| '[inverted-nesting]'| ' inner-before outer-before single-body outer-after inner-after'
+
+```bash :[single] +{outer}
+echo single-body
+```
+  Expect output: "outer-before", "inner-before", "nested body", "inner-after", and "outer-after".
+```bash :[nested] +{outer} +{inner}
+echo nested-body
+```
+```bash :[inverted-nesting] +{inner} +{outer}
+echo inverted-nesting
+```
+```bash :{inner}
+echo inner-before
+```
+```bash :{inner-after}
+echo inner-after
+```
+```bash :{outer}
+echo outer-before
+```
+```bash :{outer-after}
+echo outer-after
+```
+
+@import specs-import.md
+
+/ Import `{wrap1}` blocks. 
+```bash :[test-wrap-from-import] +{wrap-from-import}
+echo "test-wrap-from-import"
+```
+
+/ Include a wrapped block.
+```bash :[test-require-wrapped-block] +[single]
+echo "test-require-wrapped-block"
+```
+
+```opts :(disable_dump_*)
+dump_blocks_in_file: false
+dump_dependencies: false
+dump_inherited_block_names: false
+dump_inherited_dependencies: false
+dump_inherited_lines: false
+dump_menu_blocks: false
+```
+
+@import bats-document-configuration.md
+```opts :(document_options) +(disable_dump_*)
+menu_note_color: 'plain'
+menu_with_inherited_lines: false
+```

data/docs/dev/text-decoration.md

@@ -0,0 +1,7 @@
+- **_Bold-Underline_**
+- **Bold**
+- **~Bold-Italic~**
+- __Underline__
+- _~Underline-Italic~_
+- `Italic`
+- ~~Strikethrough~~

data/examples/bash-blocks.md

@@ -1,18 +1,18 @@
 # Demonstrate requiring shell blocks
 ## Requiring a named block
-::: Click below to trigger. If it prints "species", "genus", the required block was processed.
+::: Select below to trigger. If it prints "species", "genus", the required block was processed.
 The un-named block prints "species" and requires block "genus".
     ```bash +genus
     echo "species"
     ```
-::: Click below to trigger. If it prints "genus", the block was processed.
+::: Select below to trigger. If it prints "genus", the block was processed.
 The named block prints "genus".
     ```bash :genus
     echo "genus"
     ```
 
 ## Requiring a block with a nickname and a hidden block
-::: Click below to trigger. If it prints "family", "order", "class" the required blocks were processed.
+::: Select below to trigger. If it prints "family", "order", "class" the required blocks were processed.
 The named block prints "family" and requires blocks "[order]" and "(class)".
     ```bash :family +[order] +(class)
     echo "family"
@@ -39,7 +39,7 @@ The hidden block "(biology)" prints "biology".
     ```bash :(biology)
     echo "biology"
     ```
-::: Click below to trigger. If it prints "biology", "phylum", "kingdom", "domain", and "taxonomy" the required blocks were processed.
+::: Select below to trigger. If it prints "biology", "phylum", "kingdom", "domain", and "taxonomy" the required blocks were processed.
 The named block prints "kingdom" and requires blocks wrapper blocks "{phylum-domain}" and "{phylum-domain-after}".
 Notice the wrapper blocks are exclusive to the single block with the requirement.
     ```bash :kingdom +{phylum-domain} +(biology) +(taxonomy)

data/examples/block-names.md

@@ -1,6 +1,6 @@
 ## Demonstrate handling of special characters in block names
 
-::: Click below to trigger. If it prints "1","2","3","4", the Link blocks were required.
+::: Select below to trigger. If it prints "1","2","3","4", the Link blocks were required.
 Long block names can be required by a Bash block.
     ```bash :calling-block +long_block_name_12345678901234567890123456789012345678901234567890 +(long_block_name_12345678901234567890123456789012345678901234567890) +[long_block_name_12345678901234567890123456789012345678901234567890]
     echo '1'
@@ -31,7 +31,7 @@ Block names with all chars.
 / UTF-8
 /   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
 /   ¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ
-::: Click below to trigger. If it prints "Success", the Link block was processed.
+::: Select below to trigger. If it prints "Success", the Link block was processed.
 This block name uses the printable characters in the first 128 values. It is executable.
     ```link :!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
     block: (success)

data/examples/import0.md

@@ -40,3 +40,26 @@ menu_include_imported_notes: true
 ```link :page_1
 file: examples/import1.md
 ```
+
+::: Imported `{wrap1}` blocks. 
+```bash :test-wrap1 +{wrap1}
+echo "test wrap1"
+```
+
+::: Imported and Overloaded `{wrap2}` blocks. 
+```bash :test-wrap2 +{wrap2}
+echo "test wrap2 - overloaded"
+```
+```bash :{wrap2}
+echo "wrap2 before - overloaded"
+```
+```bash :{wrap2-after}
+echo "wrap2 after- overloaded"
+```
+	Local wrapped blocks, before or after the principal block, generate the same output.
+	__Output__
+		wrap2 before
+		wrap2 before - overloaded
+		test wrap2 - overloaded
+		wrap2 after
+		wrap2 after- overloaded

data/examples/import1.md

@@ -9,3 +9,16 @@ echo "page 1 block 1 visible"
 ```bash :(page1_block2)
 echo "page 1 block 2 hidden"
 ```
+
+```bash :{wrap1}
+echo "wrap1 before"
+```
+```bash :{wrap1-after}
+echo "wrap1 after"
+```
+```bash :{wrap2}
+echo "wrap2 before"
+```
+```bash :{wrap2-after}
+echo "wrap2 after"
+```

data/examples/link-blocks-vars.md

@@ -8,7 +8,7 @@ pause_after_script_execution: true
 ```
 
 ## Demonstrate a link block that sets a variable
-::: Click below to trigger. If it prints "VARIABLE1: 1", the Link block was processed.
+::: Select below to trigger. If it prints "VARIABLE1: 1", the Link block was processed.
 The hidden block "(print-VARIABLE1)" is required below. It prints variable "VARIABLE1".
 ```bash :(print-VARIABLE1)
 source bin/colorize_env_vars.sh
@@ -27,7 +27,7 @@ This block "[bash_set_to_3]" is required below. It sets the variable "ALPHA".
     ```bash :[bash_set_to_3]
     ALPHA=3
     ```
-::: Click below to trigger. If it prints "ALPHA: 3", the Link block was processed.
+::: Select below to trigger. If it prints "ALPHA: 3", the Link block was processed.
 These blocks require the *code* of the named shell block.
     ```link +[bash_set_to_3]
     block: "(display_variable_ALPHA)"
@@ -40,7 +40,7 @@ This block "[bash_set_to_4]" is required below. It prints a command that sets th
     ```bash :[bash_set_to_4]
     echo "ALPHA=4"
     ```
-::: Click below to trigger. If it prints "ALPHA: 4", the Link block was processed.
+::: Select below to trigger. If it prints "ALPHA: 4", the Link block was processed.
 These blocks require the *output* of the execution of the code in the named shell block.
     ```link +[bash_set_to_4]
     eval: true

data/examples/opts-blocks-require.md

@@ -8,21 +8,21 @@ menu_divider_color: green   # color to indicate success
 ## Automatic documents options
 ::: If this text is green, the required Opts block was processed; if this text is red, the required Opts block was NOT processed hidden, name: "(custom)"
 
-## Click this named block to test
-::: Click below to trigger. If this text starts with "+++", the required Opts block was processed; name: "custom"
+## Select this named block to test
+::: Select below to trigger. If this text starts with "+++", the required Opts block was processed; name: "custom"
     ```opts :custom
     menu_divider_format: "+++ %{line}"   # format to indicate success
     ```
 
-## Click this nicknamed block to test
-::: Click below to trigger. If this text starts with "!!!", the Opts block was processed; name: "[custom]"
+## Select this nicknamed block to test
+::: Select below to trigger. If this text starts with "!!!", the Opts block was processed; name: "[custom]"
 This block has a nickname "[custom]". It is executable.
     ```opts :[custom]
     menu_divider_format: "!!! %{line}"   # format to indicate success
     ```
 
-## Click this unnamed block to test
-::: Click below to trigger. If this text starts with "@@@", the required Opts block was processed; unnamed
+## Select this unnamed block to test
+::: Select below to trigger. If this text starts with "@@@", the required Opts block was processed; unnamed
     ```opts
     menu_divider_format: "@@@ %{line}"   # format to indicate success
     ```

data/examples/table-markup.md

@@ -0,0 +1,31 @@
+# Demonstrate Tables
+
+Table flush at left.
+Centered columns.
+| Common Name| Species| Genus| Family| Year Discovered
+|:-:|:-:|:-:|:-:|:-:
+| Tapanuli Orangutan| Pongo tapanuliensis| Pongo| Hominidae| 2017
+| Psychedelic Frogfish| Histiophryne psychedelica| Histiophryne| Antennariidae| 2009
+| Ruby Seadragon| Phyllopteryx dewysea| Phyllopteryx| Syngnathidae| 2015
+
+  Table indented with two spaces.
+  Left-justified columns.
+  | Common Name| Species| Genus| Family| Year Discovered
+  |:-|:-|:-|:-|:-
+  | Illacme tobini (Millipede)| Illacme tobini| Illacme| Siphonorhinidae| 2016
+  | Cappuccino Snake| Hydrodynastes bicinctus| Hydrodynastes| Colubridae| 2021
+  | Homo luzonensis| Homo luzonensis| Homo| Hominidae| 2019
+
+	Table indented with one tab.
+	Right-justified columns.
+	| Common Name| Species| Genus| Family| Year Discovered
+	|-:|-:|-:|-:|-:
+	| Spiny Dandelion| Taraxacum japonicum| Taraxacum| Asteraceae| 2022
+	| Mythical Monkey| Cercopithecus lomamiensis| Cercopithecus| Cercopithecidae| 2012
+	| Yeti Crab| Kiwa hirsuta| Kiwa| Kiwaidae| 2005
+
+## Non-table text is not modified
+1. |
+2. ||
+    |
+    ||