switch to Node.js markdownlint

And rework and reduce the list of excluded files for linting.

Signed-off-by: Daniel Maslowski <[email protected]>

Author: orangecms

.github/workflows/lazy-lint.bash

@@ -13,7 +13,10 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install markdown lint
-        run: sudo gem install mdl
-
-      - name: Lint markdown
-        run: .github/workflows/lazy-lint.bash
+        uses: DavidAnson/markdownlint-cli2-action@v9
+        with:
+          # keep in sync with Makefile
+          globs: |
+            src/**/*.md
+            !src/SUMMARY.md
+            !src/{case_studies/TiogaPass,coreboot.u-root.systemboot/index,u-root,utilities/dut,utilities/UEFI_Tool_Kit}.md

.github/workflows/markdownlint.yml

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "MD013": { "code_blocks": false, "tables": false },
+  "MD029": { "style": "ordered" },
+  "MD033": false,
+  "MD045": false
+}

.markdownlint.json

@@ -1,3 +1,5 @@
+MARKDOWNLINT?=markdownlint-cli2
+
 build: book i18n
 	# linkcheck causes output files to end up in html/, so move them to root
 	mv book/html/* book/
@@ -19,3 +21,12 @@ prepare: prepare_i18n
 	cargo install mdbook-mermaid
 	mdbook-mermaid install
 	cargo install mdbook-linkcheck
+
+lint_install:
+	npm i -g --prefix ~/bin/node/ markdownlint-cli2
+
+# keep in sync with .github/workflows/markdownlint.yml
+lint:
+	# NOTE: SUMMARY.md is the ToC, which has no headline
+	$(MARKDOWNLINT) src/**/*.md !src/SUMMARY.md \
+		'!src/{case_studies/TiogaPass,coreboot.u-root.systemboot/index,u-root,utilities/dut,utilities/UEFI_Tool_Kit}.md'

.mdl_style.rb

@@ -30,7 +30,7 @@ make run
 
 The book is linted with markdownlint and Vale. Follow the official
 documentation to [install
-markdownlint](https://github.com/markdownlint/markdownlint?tab=readme-ov-file#installation)
+markdownlint](https://github.com/DavidAnson/markdownlint-cli2)
 and [install Vale](https://vale.sh/docs/install). Then run `vale sync` to
 download the necessary styles.