From dfe0895d414728a5bb45a5b44e547e2787f71c91 Mon Sep 17 00:00:00 2001
From: weifanglab <weifanglab@outlook.com>
Date: Tue, 7 Jul 2026 15:51:30 +0800
Subject: [PATCH] script: check link format in Markdown files

Signed-off-by: weifanglab <weifanglab@outlook.com>
---
 scripts/link-format-chk.sh | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/scripts/link-format-chk.sh b/scripts/link-format-chk.sh
index 0c91f46646..ecf8f73f09 100755
--- a/scripts/link-format-chk.sh
+++ b/scripts/link-format-chk.sh
@@ -4,19 +4,36 @@
 # Distributed under the MIT software license, see the accompanying
 # file COPYING or http://www.opensource.org/licenses/mit-license.php.
 #
-# Check wrong mediawiki link format
+# Check wrong mediawiki and markdown link formats
 
 ECODE=0
+MEDIAWIKI_ECODE=0
 while IFS= read -r fname; do
     GRES=$(grep -nE '\]\((https?://|\.\./bip-|/bip-)' "$fname")
     if [ "$GRES" != "" ]; then
-        if [ $ECODE -eq 0 ]; then
+        if [ $MEDIAWIKI_ECODE -eq 0 ]; then
             >&2 echo "Github Mediawiki format writes links as [URL text], not as [text](URL):"
         fi
+        MEDIAWIKI_ECODE=1
         ECODE=1
         while IFS= read -r line; do
             echo "- ${fname#./}:$line"
         done <<< "$GRES"
     fi
 done < <(find . -type f -name '*.mediawiki' | sort)
+
+MARKDOWN_ECODE=0
+while IFS= read -r fname; do
+    GRES=$(grep -nE '\[[[:space:]]*https?://[^][]*\]|\[\[(\.\./|/)?bip-[^][]*\]\]' "$fname")
+    if [ "$GRES" != "" ]; then
+        if [ $MARKDOWN_ECODE -eq 0 ]; then
+            >&2 echo "Github Markdown format writes links as [text](URL), not as [URL text] or [[URL|text]]:"
+        fi
+        MARKDOWN_ECODE=1
+        ECODE=1
+        while IFS= read -r line; do
+            echo "- ${fname#./}:$line"
+        done <<< "$GRES"
+    fi
+done < <(find . -type f -name '*.md' | sort)
 exit $ECODE