vale-cli/vale

:pencil: A markup-aware linter for prose built with speed and extensibility in mind.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 46 minutes ago
Added to GitGenius on September 11th, 2026
Created on February 5th, 2017
Open Issues & Pull Requests: 28 (+0)
GitHub issues: Enabled
Number of forks: 224
Total Stargazers: 6,100 (+0)
Total Subscribers: 31 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 8.1 days
Mean response time: 143.9 days
90th percentile: 489.1 days
Tracked items: 210

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 96% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "Status: Fixed" is answered fastest, typically in about 3 days, while "Type: Enhancement" waits about 3 weeks. Only 8% of issues opened in the past year have been closed. Three people close 94% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 23
New in 7 days: 4
Closed in 7 days: 3
Avg open age: 311 days
Stale 30+ days: 18
Stale 90+ days: 14

Recent activity

Opened in 7 days: 4
Closed in 7 days: 3
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • Type: Bug (107)
  • Status: Resolved (85)
  • Status: Fixed (81)
  • Type: Enhancement (66)
  • Type: Question (45)
  • Status: Not Planned (8)
  • Status: Pending (5)
  • Status: In Progress (2)

Detailed Description

Vale is a markup-aware linter for prose built with speed and extensibility in mind.

Vale addresses the problem of maintaining consistent writing style and quality across documentation and content by analyzing text while respecting markup syntax. Rather than treating all text uniformly, the tool understands markup languages like Markdown, reStructuredText, AsciiDoc, and HTML, allowing it to lint only the prose content while ignoring code blocks, metadata, and structural elements. This markup awareness prevents false positives that generic linters produce when they flag syntax that is intentional within markup contexts.

The tool suits teams managing technical documentation, content-heavy projects, or collaborative writing environments where style consistency matters. It works well for projects already using markup-based documentation systems and needing automated enforcement of style guides. Vale is particularly valuable when you need to catch common writing issues—such as passive voice, repetitive phrasing, or terminology inconsistencies—without manual review. Organizations can define custom rules tailored to their specific style requirements, making it adaptable to different documentation standards rather than forcing adoption of a single opinionated style.

The project maintains steady development activity with regular updates addressing bug fixes and feature improvements. The codebase shows consistent attention to performance optimization, reflecting the stated design goal of speed. The tool receives ongoing refinement in its rule system and markup parsing capabilities, indicating active maintenance of core functionality. Community engagement appears present through issue resolution and feature requests, suggesting responsiveness to user needs.