nozomi-koborinai

nozomi-koborinai / contextlint

Public

đź“Ź Rule-based linter for structured Markdown documents

www.npmjs.comorgcontextlint ai-development cli linter markdown markdown-table
16
0
100% credibility
Found Mar 09, 2026 at 13 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

contextlint is a linter that validates structured Markdown documents for issues like broken references, missing sections, table inconsistencies, and checklist completeness.

How It Works

1
đź“š Discover the document checker

While writing project notes and specs in simple text files, you hear about a helpful tool that spots common mistakes like broken links or incomplete lists.

2
🛠️ Add it to your writing setup

You easily bring the checker into your project so it can scan your files anytime.

3
✨ Tell it your rules

You make a short list of things to watch for, like ensuring every table has key details or links point to real places, and it understands right away.

4
▶️ Run the check

With one quick go, it looks over all your documents and finds any slip-ups.

5
đź“‹ See the friendly report

It shows exactly what's wrong, like a missing part in a list or a link that goes nowhere, with line numbers to fix fast.

6
🔧 Make quick fixes

You update your files based on the clear suggestions, and everything feels organized.

🎉 Perfect documents every time

Now your project notes stay reliable, with no hidden errors, making teamwork and reviews smooth and confident.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 13 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is contextlint?

contextlint is a TypeScript rule-based linter for structured Markdown documents, scanning for broken references, duplicate IDs, missing sections, and table issues like empty cells or invalid values. It ensures doc integrity in spec-driven workflows where Markdown forms a dependency graph—requirements link to designs, ADRs reference RFCs—catching silent breaks deterministically without AI. Install via npm, configure with JSON schema for IDE autocomplete, and run `npx contextlint` in CI.

Why is it gaining traction?

Unlike general Markdown linters, it targets semantic rules for tables, cross-file links, stability propagation, and checklists, complementing syntax tools perfectly. The CLI auto-detects configs, supports glob patterns, and integrates as an MCP server for AI chats in Claude or Cursor—ideal for rule-based validation in AI-assisted dev without runtime costs. Multilingual READMEs and precise output make it dev-friendly for global teams.

Who should use this?

Teams in spec-driven development (SDD) maintaining requirements tables, ADRs, or RFCs with interconnected Markdown files. Architects enforcing section orders or unique IDs across docs/zones; technical writers validating checklists and links in CI pipelines.

Verdict

Worth adding to Markdown-heavy repos for its focused rules and CI fit, despite 12 stars and 1.0% credibility signaling early maturity—docs are excellent, tests thorough, but adoption is nascent. Prototype it on your docs folder today.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.