# markdownlint/markdownlint

Markdown lint tool

Repository: https://github.com/markdownlint/markdownlint
Canonical: https://ross.abutalabs.com/products/markdownlint-markdownlint
Language: Ruby
License: MIT
License Family: permissive
Topics: markdownlint, markdown, ruby
Last push: 2026-08-09T19:12:44+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 35, longevity 100
- inputs: {"age_days": 4476, "days_push": 24, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2073, forks 250 (observed 2026-08-28T04:06:10.486119+00:00)

## What it is
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
- artifact type: cli-tool
- maturity: active
- function: linter, markdown, cli
- domain: developer-tools, documentation
- platform: cli, cross-platform, ruby
- tags: markdown-style-checker, ruby-gem, style-files, documentation-quality, command-line

## Member repositories
- markdownlint/markdownlint (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:10.486119+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:56:30.217371+00:00, confidence not recorded.
  - readme: https://github.com/markdownlint/markdownlint (fetched 2026-08-28T04:06:10.486119+00:00, sha 915db9533149)
- Data as of 2026-08-30T08:39:29.467469+00:00.