feat: Add markdownlint workflow and configuration for improved documentation formatting

Author: timothywarner

.github/workflows/markdownlint.yml

@@ -0,0 +1,27 @@
+name: Markdownlint Fixup
+
+on:
+  workflow_dispatch:
+
+jobs:
+  markdownlint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install markdownlint-cli2
+        run: npm install --no-save markdownlint-cli2
+
+      - name: Run markdownlint fix
+        run: npx markdownlint-cli2-fix "**/*.md" "#node_modules" "#dist"
+
+      - name: Show git diff
+        run: git status --short && git diff
+*** End Patch

.markdownlint.json

@@ -0,0 +1,45 @@
+{
+  "default": true,
+  "MD003": {
+    "style": "atx"
+  },
+  "MD007": {
+    "indent": 2
+  },
+  "MD009": {
+    "br_spaces": 2,
+    "ignore_code_blocks": true
+  },
+  "MD012": {
+    "maximum": 1
+  },
+  "MD013": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false,
+    "headings": false
+  },
+  "MD022": {
+    "lines_above": 1,
+    "lines_below": 1
+  },
+  "MD023": true,
+  "MD025": {
+    "front_matter_title": "^#"
+  },
+  "MD026": {
+    "punctuation": ".,;:!"
+  },
+  "MD029": {
+    "style": "ordered"
+  },
+  "MD032": true,
+  "MD033": false,
+  "MD035": {
+    "style": "---"
+  },
+  "MD041": true,
+  "MD046": {
+    "style": "fenced"
+  }
+}