Revert "lint: fmt README.md (#694)"

.github/workflows/linting.yaml

@@ -10,14 +10,41 @@ on:
   workflow_dispatch:
 
 jobs:
-  lint:
-    name: Lint
+  mdlint:
+    name: Markdown Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: xt0rted/markdownlint-problem-matcher@v3
+
+      - run: npm install -g markdownlint-cli
+
+      # disabled checks:
+      # - MD013/line-length
+      # - MD033/no-inline-html
+      # - MD034/no-bare-urls
+      # - MD036/no-emphasis-as-heading
+      # - MD041/first-line-heading/first-line-h1
+      - run: |
+          markdownlint --version
+
+          # List files to lint
+          ls *.md **/*.md
+
+          markdownlint \
+            --ignore '**/CHANGELOG.md' \
+            --disable MD013 MD033 MD034 MD036 MD041 -- \
+            *.md **/*.md
+
+  zshlint:
+    name: ZSH Lint
     runs-on: ubuntu-latest
 
     strategy:
       fail-fast: false
       matrix:
-        task: [markdown, zsh-noexec, zsh-zcompile]
+        task: [zsh-noexec, zsh-zcompile]
 
     steps:
       - uses: actions/checkout@v4
@@ -30,15 +57,10 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install --yes zsh
-          pip install --user linkify-it-py mdformat mdformat-config mdformat-gfm mdformat-shfmt mdformat-tables mdformat-toc
 
       - name: "run lint (${{ matrix.task }})"
         run: |
           case "${{ matrix.task }}" in
-            markdown)
-              find . -name '*.md' ! -name 'CHANGELOG.md' -type f -print0 \
-                | xargs -0 -n1 -P4 mdformat --check --wrap 120 --number
-              ;;
             zsh-noexec)
               find . -name '*.zsh' -type f -print0 \
                 | xargs -0 -n1 -P4 zsh -n