Extend Markdown linters comparison page and link from README (#204)

* docs: extend linter comparison with Hugo, query, security, future plans

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/71eb11d4-360d-4297-8a26-1800769b40ae

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

* docs: merge rules-lacks table into structural linting with plan annotations

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/bb8f681c-272f-45b5-90e0-70c7aed81522

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* docs: use catalog directive for README comparison link; fix review issues; add Obsidian

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/3991a7bc-82a8-4cb8-bcc2-78a21b8fe49a

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

* docs: add plans 124-127 for missing rules (space-in-code, space-in-links, proper-names, single-H1)

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/86a0ecef-882c-4f8e-b485-e94e86adbad1

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

* plan: add 128/129 for undefined and unused reference-link labels

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/60d0ccb6-54d1-4e76-8ef2-45e329bf398b

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

* plan: drop invalid `enabled:` config keys, fix spelling and message case

Agent-Logs-Url: https://github.com/jeduden/mdsmith/sessions/9c7474b1-6cbb-474a-a72d-9f8390848936

Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jeduden <1117699+jeduden@users.noreply.github.com>
Co-authored-by: Jan-Eric Duden <jeduden@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.github/copilot-instructions.md

@@ -29,7 +29,7 @@ row: "- [{summary}](../{filename})"
 - [Shared patterns (archetypes) reused across multiple linting rules.](../docs/background/archetypes/README.md)
 - [How "flavor" (a property of the renderer), "rule" (a single check), "convention" (a project-wide bundle), and "kind" (a per-file role tag) differ in mdsmith, the cases where they overlap, and how the four concepts compose.](../docs/background/concepts/flavor-rule-convention-kind.md)
 - [How the placeholder vocabulary lets rules treat template tokens as opaque rather than flagging them as content violations.](../docs/background/concepts/placeholder-grammar.md)
-- [Comparison of mdsmith with other Markdown linters and formatters.](../docs/background/markdown-linters.md)
+- [How mdsmith compares to other Markdown linters.](../docs/background/markdown-linters.md)
 - [Codecov coverage gate and CI status checks.](../docs/development/coverage.md)
 - [Where to place Markdown files and documentation types.](../docs/development/file-placement.md)
 - [Build commands, project layout, code style, test fixtures, coverage gate, and merge conflicts.](../docs/development/index.md)

AGENTS.md

@@ -35,7 +35,7 @@ row: "- [{summary}]({filename})"
 - [Shared patterns (archetypes) reused across multiple linting rules.](docs/background/archetypes/README.md)
 - [How "flavor" (a property of the renderer), "rule" (a single check), "convention" (a project-wide bundle), and "kind" (a per-file role tag) differ in mdsmith, the cases where they overlap, and how the four concepts compose.](docs/background/concepts/flavor-rule-convention-kind.md)
 - [How the placeholder vocabulary lets rules treat template tokens as opaque rather than flagging them as content violations.](docs/background/concepts/placeholder-grammar.md)
-- [Comparison of mdsmith with other Markdown linters and formatters.](docs/background/markdown-linters.md)
+- [How mdsmith compares to other Markdown linters.](docs/background/markdown-linters.md)
 - [Codecov coverage gate and CI status checks.](docs/development/coverage.md)
 - [Where to place Markdown files and documentation types.](docs/development/file-placement.md)
 - [Build commands, project layout, code style, test fixtures, coverage gate, and merge conflicts.](docs/development/index.md)

CLAUDE.md

@@ -21,7 +21,7 @@ row: "- [{summary}]({filename})"
 - [Shared patterns (archetypes) reused across multiple linting rules.](docs/background/archetypes/README.md)
 - [How "flavor" (a property of the renderer), "rule" (a single check), "convention" (a project-wide bundle), and "kind" (a per-file role tag) differ in mdsmith, the cases where they overlap, and how the four concepts compose.](docs/background/concepts/flavor-rule-convention-kind.md)
 - [How the placeholder vocabulary lets rules treat template tokens as opaque rather than flagging them as content violations.](docs/background/concepts/placeholder-grammar.md)
-- [Comparison of mdsmith with other Markdown linters and formatters.](docs/background/markdown-linters.md)
+- [How mdsmith compares to other Markdown linters.](docs/background/markdown-linters.md)
 - [Codecov coverage gate and CI status checks.](docs/development/coverage.md)
 - [Where to place Markdown files and documentation types.](docs/development/file-placement.md)
 - [Build commands, project layout, code style, test fixtures, coverage gate, and merge conflicts.](docs/development/index.md)

PLAN.md

@@ -32,6 +32,12 @@ footer: |
 | 113 | 🔲     | sonnet | [User-defined Markdown conventions](plan/113_user-defined-profiles.md)                               |
 | 114 | ✅     | sonnet | [MDS034 message clarity and flavor-vs-rule docs](plan/114_mds034-message-and-flavor-vs-rule-docs.md) |
 | 120 | 🔲     | sonnet | [Unify glob matcher and field naming across mdsmith](plan/120_glob-unification.md)                   |
+| 124 | 🔲     | sonnet | [No space inside code spans rule](plan/124_no-space-in-code-spans.md)                                |
+| 125 | 🔲     | sonnet | [No space inside link text rule](plan/125_no-space-in-link-text.md)                                  |
+| 126 | 🔲     | sonnet | [Proper-name capitalization rule](plan/126_proper-names.md)                                          |
+| 127 | 🔲     | sonnet | [Single H1 per file rule](plan/127_single-h1.md)                                                     |
+| 128 | 🔲     | sonnet | [Reject undefined reference-link labels](plan/128_no-undefined-reference-labels.md)                  |
+| 129 | 🔲     | sonnet | [Flag unused or duplicate link reference definitions](plan/129_no-unused-link-definitions.md)        |
 | 52  | ✅     |        | [Archetype / Template Library for Agentic Patterns](plan/52_archetype-template-library.md)           |
 | 61  | ✅     |        | [Required Structure Rule Hardening](plan/61_required-structure-hardening.md)                         |
 | 65  | ✅     |        | [Spike WASM-Embedded Weasel Inference](plan/65_spike-wasm-embedded-inference.md)                     |

README.md

@@ -68,6 +68,15 @@ binary. No network calls. Drop the output into
 `.cursor/rules`, `AGENTS.md`, or `CLAUDE.md` and your
 agent knows the rules without an extra fetch.
 
+**🆚 How does it compare?** See:
+<?catalog
+glob:
+  - "docs/background/markdown-linters.md"
+row: "- [{summary}]({filename})"
+?>
+- [How mdsmith compares to other Markdown linters.](docs/background/markdown-linters.md)
+<?/catalog?>
+
 ## 📦 Installation
 
 ```bash