ci: add markdown linting workflow

.github/workflows/ci.yaml

@@ -0,0 +1,17 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@v15
+        with:
+          globs: "**/*.md"

.markdownlint-cli2.jsonc

@@ -0,0 +1,6 @@
+{
+  "config": {
+    "MD013": false, // Disable line length rule as it's often too restrictive for docs
+    "MD041": false  // Disable first-line heading rule (frontmatter often comes first)
+  }
+}