From c6a38da28f2fccbfe32267712a4f7875e7a5c012 Mon Sep 17 00:00:00 2001
From: "gandalf-the-greybeard[bot]"
 <gandalf-the-greybeard[bot]@users.noreply.github.com>
Date: Wed, 11 Mar 2026 01:40:53 +0000
Subject: [PATCH] ci: add markdown linting workflow

---
 .github/workflows/ci.yaml | 17 +++++++++++++++++
 .markdownlint-cli2.jsonc  |  6 ++++++
 2 files changed, 23 insertions(+)
 create mode 100644 .github/workflows/ci.yaml
 create mode 100644 .markdownlint-cli2.jsonc

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
new file mode 100644
index 0000000..4dd4d1e
--- /dev/null
+++ b/.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"
diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc
new file mode 100644
index 0000000..0a7efc5
--- /dev/null
+++ b/.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)
+  }
+}