markdown auto-convert

Author: TJTheCoder

driver-ci

@@ -29,25 +29,47 @@ TUTORIAL_DST="$DOCS_SOURCE_DIR/tutorial.md"
 {
     found_title=false
     while IFS= read -r line; do
+        # Replace first heading with '# Tutorial'
         if ! $found_title && [[ "$line" =~ ^# ]]; then
             echo "# Tutorial"
             found_title=true
+            continue
+        fi
+
+        # Convert [!XYZ] → ```{xyz}
+        if [[ "$line" =~ ^\[!\([A-Z]+\)\] ]]; then
+            admonition=$(echo "$line" | sed -E 's/^\[!([A-Z]+)\].*/\L\1/')  # lowercase XYZ
+            content=$(echo "$line" | sed -E 's/^\[![A-Z]+\]\s*//')
+            echo "\`\`\`{$admonition}"
+            echo "$content"
+            echo "\`\`\`"
         else
             echo "$line"
         fi
     done < "$TUTORIAL_SRC"
 } > "$TUTORIAL_DST"
 
-# === Copy and transform README.md into index.md ===
+# === Copy and transform README.md into index.md (Home) ===
 README_SRC="$TMP_DIR/amago-crr_k/README.md"
 INDEX_DST="$DOCS_SOURCE_DIR/index.md"
 
 {
     found_title=false
     while IFS= read -r line; do
+        # Replace first heading with '# Home'
         if ! $found_title && [[ "$line" =~ ^# ]]; then
             echo "# Home"
             found_title=true
+            continue
+        fi
+
+        # Convert [!XYZ] → ```{xyz}
+        if [[ "$line" =~ ^\[!\([A-Z]+\)\] ]]; then
+            admonition=$(echo "$line" | sed -E 's/^\[!([A-Z]+)\].*/\L\1/')  # lowercase XYZ
+            content=$(echo "$line" | sed -E 's/^\[![A-Z]+\]\s*//')
+            echo "\`\`\`{$admonition}"
+            echo "$content"
+            echo "\`\`\`"
         else
             echo "$line"
         fi
@@ -69,4 +91,4 @@ make html
 # === Copy media into final HTML output ===
 cd "$BUILD_DIR/html"
 mkdir -p media
-cp -r "$STATIC_MEDIA_DIR"/* media/
+cp -r "$STATIC_MEDIA_DIR"/* media/