Setup markdownlint and fix markdown lint violations

Author: data-douser

.github/workflows/lint-and-format.yml

@@ -26,16 +26,20 @@ jobs:
           node-version-file: '.node-version'
 
       - name: Lint and Format - Install node dependencies for all workspaces
-        run: npm ci --workspaces
+        run: npm ci
 
       - name: Lint and Format - Run eslint
         run: npm run lint
 
       - name: Lint and Format - Run prettier format check
         run: npm run format:check
 
+      - name: Lint and Format - Run markdownlint
+        run: npm run lint:md
+
       - name: Lint and Format - Summary
         run: |
           echo "## Lint and Format Check Summary" >> $GITHUB_STEP_SUMMARY
           echo "✅ ESLint checks completed on all workspaces" >> $GITHUB_STEP_SUMMARY
           echo "✅ Prettier format checks completed" >> $GITHUB_STEP_SUMMARY
+          echo "✅ Markdownlint checks completed" >> $GITHUB_STEP_SUMMARY

.markdownlint.yml

@@ -0,0 +1,15 @@
+# markdownlint configuration
+# https://github.com/DavidAnson/markdownlint/blob/main/schema/.markdownlint.yaml
+#
+# This config is consumed by:
+#   1. The repo-maintained `npm run lint:md` script (markdownlint-cli)
+#   2. The org-required `markdown-lint.yml` workflow (markdownlint-cli)
+
+# MD013 - Line length: disabled (handled by prettier)
+MD013: false
+
+# MD024 - Multiple headings with the same content: allow across sections
+# Changelogs and release notes intentionally repeat headings like
+# "### Added", "### Changed", "#### MCP Server Tools" under each version.
+MD024:
+  siblings_only: true

.markdownlintignore

@@ -0,0 +1,16 @@
+node_modules
+**/node_modules
+server/dist
+coverage
+server/coverage
+extensions/vscode/coverage
+extensions/vscode/.vscode-test
+extensions/vscode/test/fixtures
+server/ql/*/tools/test/*
+server/src/prompts/
+server/src/resources/
+workshops
+**/*.testproj
+client/**/after/
+client/**/before/
+query-results*

CHANGELOG.md

@@ -215,7 +215,7 @@ _Changes on `main` since the latest tagged release that have not yet been includ
 
 ### New Contributors
 
-- [@dependabot](https://github.com/dependabot)[bot] made their first contribution in [#49](https://github.com/advanced-security/codeql-development-mcp-server/pull/49)
+- @dependabot\[bot\] made their first contribution in [#49](https://github.com/advanced-security/codeql-development-mcp-server/pull/49)
 - [@MichaelRFairhurst](https://github.com/MichaelRFairhurst) made their first contribution in [#70](https://github.com/advanced-security/codeql-development-mcp-server/pull/70)
 - @github-actions[bot] made their first contribution in [#65](https://github.com/advanced-security/codeql-development-mcp-server/pull/65)