How the SCSS Formatter works

The formatter understands SCSS syntax beyond plain CSS: nested rules, parent selectors with an ampersand, variables, mixins and includes, functions, maps and control directives such as if and each. It prints each construct with consistent spacing and indentation.

Line comments, which are valid in SCSS but not in CSS, are preserved. If the input cannot be parsed, the first error is reported with its position.

When it is useful

• •Normalizing partial files from different contributors.
• •Reading deeply nested styles that were written on one line.
• •Checking that a snippet is valid SCSS.
• •Preparing code for review or documentation.

Frequently Asked Questions