.gitea/workflows/markdown-lint.yml

@@ -0,0 +1,35 @@
+name: Markdown Validation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+jobs:
+  amd64:
+    runs-on: [ ubuntu-24.04, amd64-builder ]
+    steps:
+      - name: System Info
+        run: uname -m
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Install markdownlint-cli
+        run: |
+          npm ci || npm install
+          npm i -D markdownlint-cli
+
+      - name: Run markdownlint
+        # The glob pattern finds all markdown files recursively.
+        # Adjust if you store docs elsewhere (e.g., docs/**/*.md).
+        run: |
+          npx markdownlint "**/*.md" \
+            --ignore node_modules \
+            --config .markdownlint.json

.markdownlint.json

@@ -0,0 +1,8 @@
+{
+  "default": true,
+
+  // Example customisations – adjust or delete as needed
+  "MD013": { "line_length": 120 },   // max line length (set higher if you prefer)
+  "MD041": false,                    // allow first line not to be a top‑level heading
+  "MD033": false                     // allow inline HTML (useful for Gollum embeds)
+}