OS Manuals

/usr/bin/vale

A syntax-aware linter for prose built with speed and extensibility in mind

From vale 3.26.0-r0 (os), captured 2026-11-05 by running vale --help (exit 0). permalink

vale - A command-line linter for prose.

Usage:	vale [options] [input...]
	vale myfile.md myfile1.md mydir1
	vale --output=JSON [input...]

Vale is a syntax-aware linter for prose built with speed and extensibility in
mind. It supports Markdown, AsciiDoc, reStructuredText, HTML, and more.

To get started, you'll need a configuration file (.vale.ini):

Example:

	MinAlertLevel = suggestion

	[*]
	BasedOnStyles = Vale

See https://vale.sh for more setup information.

Flags:

 --config         A file path (--config='some/file/path/.vale.ini').
 --output         An output style ("line", "JSON", or a template file).
 --minAlertLevel  The minimum level to display (--minAlertLevel=error).
 --glob           A glob pattern (--glob='*.{md,txt}').
 --filter         An expression to filter rules by.
 -h, --help       Print this help message.
 -v, --version    Print the current version.


More flags:

 --coverage        With `vale test`: fail when a rule produced no alert in any case.
 --ext             An extension to associate with stdin (--ext=.md).
 --ignore-syntax   Lint all files line-by-line.
 --no-color        Don't colorize CLI output.
 --no-exit         Don't return a nonzero exit code on errors.
 --no-global       Don't load the global configuration.
 --no-wrap         Don't wrap CLI output.
 --path            A file path to associate with stdin (--path=docs/example.md).
 --plain-progress  Log each step instead of drawing a progress bar.


Commands:

 ls-config   Print the current configuration to stdout.
 ls-dirs     Print the default configuration directories to stdout.
 ls-metrics  Print the given file's internal metrics to stdout.
 ls-vars     Print the supported environment variables to stdout.
 sync        Download and install external configuration sources.
 test        Run the test cases kept beside a configuration's rules.

Run vale <command> --help for a command's own help.
Options (16)
OptionDescriptionSource
--configA file path (--config='some/file/path/.vale.ini').help
--outputAn output style ("line", "JSON", or a template file).help
--minAlertLevelThe minimum level to display (--minAlertLevel=error).help
--globA glob pattern (--glob='*.{md,txt}').help
--filterAn expression to filter rules by.help
-h, --helpPrint this help message.help
-v, --versionPrint the current version.help
--coverageWith `vale test`: fail when a rule produced no alert in any case.help
--extAn extension to associate with stdin (--ext=.md).help
--ignore-syntaxLint all files line-by-line.help
--no-colorDon't colorize CLI output.help
--no-exitDon't return a nonzero exit code on errors.help
--no-globalDon't load the global configuration.help
--no-wrapDon't wrap CLI output.help
--pathA file path to associate with stdin (--path=docs/example.md).help
--plain-progressLog each step instead of drawing a progress bar.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.