Fix Markdown checks

.github/workflows/build-check.yaml

@@ -129,9 +129,6 @@ jobs:
       - name: Checkout Repo
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
-      - name: install dependencies
-        run: npm install
-
       - name: run markdown-link-check
         run: make markdown-link-check
 
@@ -141,8 +138,5 @@ jobs:
       - name: Checkout Repo
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
-      - name: install dependencies
-        run: npm install
-
       - name: run markdownlint
         run: make markdownlint

.markdownlint.yaml

@@ -11,4 +11,6 @@ no-duplicate-header:
 ol-prefix:
   style: ordered
 no-inline-html: false
-fenced-code-language: false
+fenced-code-language: false
+MD024: false
+MD059: false

Makefile

@@ -172,17 +172,18 @@ ALL_DOCS := $(shell find . -type f -name '*.md' -not -path './.github/*' -not -p
 markdown-link-check:
 	docker run --rm \
 		--mount 'type=bind,source=$(PWD),target=/home/repo' \
-		lycheeverse/lychee \
+		lycheeverse/lychee:sha-3a09227-alpine \
 		--config home/repo/.lychee.toml \
 		--root-dir /home/repo \
 		-v \
 		home/repo
 
 .PHONY: markdownlint
 markdownlint:
-	@if ! npm ls markdownlint; then npm install; fi
 	@for f in $(ALL_DOCS); do \
 		echo $$f; \
-		npx --no -p markdownlint-cli markdownlint -c .markdownlint.yaml $$f \
-			|| exit 1; \
+		docker run --rm \
+			--mount 'type=bind,source=$(PWD),target=/workdir' \
+			davidanson/markdownlint-cli2:v0.18.1 \
+			--config .markdownlint.yaml $$f || exit 1; \
 	done

docs/specification.md

@@ -1,3 +1,4 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
 <!--- Hugo front matter used to generate the website version of this page:
 title: OTLP Specification
 linkTitle: OTLP