Summary
The .markdownlint-cli2.jsonc configuration (line 12) excludes collections/*.collection.md from linting. This exclusion should be removed by fixing the underlying lint violations so these auto-generated files pass the full linting pipeline.
Context
During work on #1256 / PR #1316, the exclusion was investigated for removal. Running markdownlint against these files produces 23 errors across the collection:
| Rule |
Count |
Description |
search-replace/no-em-dash |
21 |
Em dash (—) in frontmatter description fields |
MD041 |
1 |
First line is not a top-level heading |
MD013 |
1 |
Line length exceeds configured limit |
The cleanup was deferred to keep PR #1316 focused on its original scope.
Scope
- Fix 21
no-em-dash violations — Replace em dashes in frontmatter description fields across collections/*.collection.md files with compliant alternatives (hyphens or rephrased text).
- Fix
MD041 violation — Ensure every collection.md file starts with a top-level heading.
- Fix
MD013 violation — Wrap or shorten the offending long line.
- Remove the exclusion from
.markdownlint-cli2.jsonc line 12.
- Update references to this exclusion in:
scripts/linting/Validate-MarkdownFrontmatter.ps1 (line 36 area)
.github/copilot-instructions.md (line 105 area, if still referencing the exclusion)
- Regenerate plugin outputs — Run
npm run plugin:generate after changes to confirm pipeline still passes.
Related
Acceptance Criteria
Summary
The
.markdownlint-cli2.jsoncconfiguration (line 12) excludescollections/*.collection.mdfrom linting. This exclusion should be removed by fixing the underlying lint violations so these auto-generated files pass the full linting pipeline.Context
During work on #1256 / PR #1316, the exclusion was investigated for removal. Running markdownlint against these files produces 23 errors across the collection:
search-replace/no-em-dash—) in frontmatterdescriptionfieldsMD041MD013The cleanup was deferred to keep PR #1316 focused on its original scope.
Scope
no-em-dashviolations — Replace em dashes in frontmatterdescriptionfields acrosscollections/*.collection.mdfiles with compliant alternatives (hyphens or rephrased text).MD041violation — Ensure every collection.md file starts with a top-level heading.MD013violation — Wrap or shorten the offending long line..markdownlint-cli2.jsoncline 12.scripts/linting/Validate-MarkdownFrontmatter.ps1(line 36 area).github/copilot-instructions.md(line 105 area, if still referencing the exclusion)npm run plugin:generateafter changes to confirm pipeline still passes.Related
Acceptance Criteria
npx markdownlint-cli2 "collections/*.collection.md"produces zero errors.markdownlint-cli2.jsoncno longer excludescollections/*.collection.mdnpm run plugin:generateandnpm run plugin:postprocesspass cleanlynpm run lint:mdpasses with no regressions