Vale: Your Style, Our Editor

Vale is a natural language linter that supports plain text, markup (Markdown, reStructuredText, AsciiDoc, and HTML), and source code comments. Vale doesn't attempt to offer a one-size-fits-all collection of rules—instead, it strives to make customization as easy as possible.

Check out project website to learn more!

• Supports Markdown, reStructuredText, AsciiDoc, HTML, and source code.
• Extensible through straightforward YAML files.
• Standalone binaries for Windows, macOS, and Linux.
• Expressive, EditorConfig-like configuration.

There are a few options to choose from:

• Install through Homebrew on macOS:

  $ brew tap ValeLint/vale
  $ brew install vale

• Install via the Windows Installer package (.msi) on the releases page.

• Manually install on Windows, macOS, or Linux by downloading an executable from the releases page.

Run Vale on a single file:

$ vale README.md

Run Vale on files matching a particular glob:

# Only lint Markdown and reStructuredText
$ vale --glob='*.{md,rst}' directory

Or exclude files matching a particular glob:

# Ignore all `.txt` files
$ vale --glob='!*.txt' directory

Pipe input to Vale:

$ echo 'this is some text' | vale

Run Vale on text with an assigned syntax:

$ vale --ext=.md 'this is some text'

See vale --help and Configuration for more information.

• Atom—TimKam/atomic-vale
• Sublime Text—ValeLint/SubVale

To use one of these styles, you'd copy its files onto your StylesPath and then specify it in your config file:

# This goes in a file named either `.vale` or `_vale`.

StylesPath = path/to/some/directory
MinAlertLevel = warning # suggestion, warning or error

[*.{md,txt}] # Only Markdown and .txt files
# List of styles to load
BasedOnStyles = vale, Joblint
# Style.Rule = {YES, NO, suggestion, warning, error} to 
# enable/disable a rule or change its level.
vale.Editorializing = NO

See Configuration and Styles for more information.