add markdownlint

.github/workflows/lint-md.yml

@@ -0,0 +1,24 @@
+name: Lint Markdown
+
+on:
+  pull_request:
+    paths:
+      - '**/*.md'
+
+jobs:
+  markdownlint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install markdownlint-cli
+        run: npm install -g markdownlint-cli
+
+      - name: Run markdownlint
+        run: markdownlint "**/*.md" --config .markdownlint.json

.github/workflows/test-pull-request.yml

@@ -42,23 +42,17 @@ jobs:
           # Full git history is needed to get a proper list of changed files
           # within `super-linter`
           fetch-depth: 0
-      - name: Load Super Linter Environment
-        run: cat ".github/super-linter.env" >> "$GITHUB_ENV"
-
-      ################################
-      # Run Linters against code base #
-      ################################
-      - name: Lint Code Base
-        #
-        # Use full version number to avoid cases when a next
-        # released version is buggy
-        # About slim image: https://github.com/github/super-linter#slim-image
-        uses: github/super-linter/slim@v4.10.1
+
+      - name: Run Super Linter
+        uses: github/super-linter@v5
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VALIDATE_MARKDOWN: true
+          VALIDATE_YAML: true
+          VALIDATE_JSON: true
+          MARKDOWN_CONFIG_FILE: .markdownlint.json
           DEFAULT_BRANCH: main
-          VALIDATE_ALL_CODEBASE: false
-          VALIDATE_GITHUB_ACTIONS: true
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VALIDATE_ALL_CODEBASE: true
 
       - name: Setup Node v16 for Yarn v3
         uses: actions/setup-node@v3
@@ -83,7 +77,7 @@ jobs:
       - name: Check internal links
         uses: borales/actions-yarn@v3
         with:
-          cmd: test:links
+          cmd: checkLinks
 
       - name: Build site
         if: ${{ success() }}
@@ -104,10 +98,10 @@ jobs:
         uses: actions/setup-node@v3
         with:
           node-version: '18'
-          
+
       - name: Enable Corepack for Yarn v3
         run: corepack enable
-        
+
       - name: Install Yarn v3
         uses: borales/actions-yarn@v3
         with:
@@ -132,22 +126,22 @@ jobs:
           YARN_ENABLE_HARDENED_MODE: false
         with:
           cmd: install --mode=update-lockfile
-          
+
       - name: Run PR script
         run: node src/pr-scripts.js
         env:
           PR_ID: ${{ github.event.pull_request.number }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          
+
       - name: Run AI metadata generation script
         run: node src/ai-scripts.js
         env:
           AZURE_OPENAI_ENDPOINT: ${{ secrets.AZURE_OPENAI_ENDPOINT }}
           AZURE_OPENAI_API_KEY: ${{ secrets.AZURE_OPENAI_API_KEY }}
           FILE_NAME: "pr_content.txt"
-          
+
       - name: Run review PR script
         run: node src/review-scripts.js
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PR_ID: ${{ github.event.pull_request.number }}
+          PR_ID: ${{ github.event.pull_request.number }}

.markdownlint.json

@@ -0,0 +1,10 @@
+{
+  "default": false,
+  "MD009": true,
+  "MD012": true,
+  "MD013": false,
+  "MD041": true,
+  "MD025": true,
+  "MD024": true,
+  "MD026": true
+}

.markdownlintignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+CHANGELOG.md
+docs/old/

package.json

@@ -30,7 +30,7 @@
     "build": "gatsby build",
     "serve": "gatsby serve",
     "clean": "gatsby clean",
-    "lint": "docker run --rm -e RUN_LOCAL=true --env-file '.github/super-linter.env' -v \"$PWD\":/tmp/lint github/super-linter:slim-v4.10.1",
+    "lint:md": "markdownlint-cli '**/*.md' --config .markdownlint.json",
     "buildNavigation": "npx --yes github:AdobeDocs/adp-devsite-utils buildNavigation -v",
     "buildRedirections": "npx --yes github:AdobeDocs/adp-devsite-utils buildRedirections -v",
     "renameFiles": "npx --yes github:AdobeDocs/adp-devsite-utils renameFiles -v",
@@ -47,7 +47,7 @@
   "devDependencies": {
     "express": "5.1.0",
     "glob": "11.0.0",
-    "markdown-link-check": "^3.13.7",
+    "markdownlint-cli": "^0.39.0",
     "remark-cli": "^11.0.0",
     "remark-validate-links": "^12.1.0"
   }