yamllint documentation

A linter for YAML files.

yamllint does not only check for syntax validity, but for weirdnesses like key repetition and cosmetic problems such as lines length, trailing spaces, indentation, etc.

Screenshot

Note

The default output format is inspired by eslint, a great linting tool for Javascript.

Table of contents

• Quickstart
  • Installing yamllint
  • Running yamllint
• Configuration
  • Default configuration
  • Extending the default configuration
  • Custom configuration without a config file
  • Errors and warnings
  • Ignoring paths
• Rules
  • braces
  • brackets
  • colons
  • commas
  • comments
  • comments-indentation
  • document-end
  • document-start
  • empty-lines
  • empty-values
  • hyphens
  • indentation
  • key-duplicates
  • key-ordering
  • line-length
  • new-line-at-end-of-file
  • new-lines
  • octal-values
  • quoted-strings
  • trailing-spaces
  • truthy
• Disable with comments
  • Disabling checks for a specific line
  • Disabling checks for all (or part of) the file
• Development
• Integration with text editors
  • Vim
  • Neovim
  • Emacs
  • Other text editors
• Integration with other software
  • Integration with pre-commit