markdownlint/markdownlint

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

2073 stars · 250 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

markdownlint (mdl) is a Ruby-based command-line tool that checks Markdown files and flags style issues according to configurable rules. It supports custom style files so teams can enforce their own Markdown conventions.

Use cases

• lint markdown files for style issues
• enforce consistent markdown style across a project
• check all markdown files in a docs directory
• configure custom markdown style rules for a team
• validate markdown in CI pipelines

When to choose

• you write documentation in Markdown and want automated style checks
• your team needs a configurable, rule-based Markdown linter
• you prefer a Ruby-based tool installable via RubyGems or system packages

When to avoid

• you need a JavaScript/Node-based linter to integrate with npm tooling (markdownlint-cli may fit better)
• you need Markdown rendering or conversion rather than linting
• your project has no Ruby runtime available and package managers don't carry mdl

Facets

cli-tool · maturity active

linter markdown cli developer-tools documentation cli cross-platform ruby markdown-style-checker ruby-gem style-files documentation-quality command-line

Member repositories

For agents

markdown · JSON · MCP: product_card(name="markdownlint/markdownlint")