--- /dev/null
+# indentation
+
+Specify indentation.
+
+```css
+ |@media print {
+ | a {
+ | ↑ background-position: top left,
+ | ↑ ↑ top right;
+ | ↑}↑ ↑
+ |}↑ ↑ ↑
+/** ↑ ↑ ↑
+ * The indentation at these three points */
+```
+
+The `--fix` option on the [command line](../../../docs/user-guide/cli.md#autofixing-errors) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`int|"tab"`, where `int` is the number of spaces
+
+### `2`
+
+Always indent at-rules, rules, comments, declarations, inside parentheses and multi-line values by 2 spaces.
+
+The following patterns are considered violations:
+
+```css
+@media print {
+a {
+background-position: top left,
+top right;
+}
+}
+```
+
+```css
+@media print {
+a {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+```css
+@media print {
+ a {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+```css
+@media print {
+ a,
+ b {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+```css
+a {
+/* blergh */
+ color: pink;
+}
+ /* blergh */
+```
+
+```css
+@media print,
+(-webkit-min-device-pixel-ratio: 1.25),
+(min-resolution: 120dpi) {}
+```
+
+```css
+a {
+ color: rgb(
+ 255,
+ 255,
+ 255
+ );
+ top: 0;
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+@media print {
+ a {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+```css
+@media print {
+ a,
+ b {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+```css
+a {
+ /* blergh */
+ color: pink;
+}
+/* blergh */
+```
+
+```css
+@media print,
+ (-webkit-min-device-pixel-ratio: 1.25),
+ (min-resolution: 120dpi) {}
+```
+
+```css
+a {
+ color: rgb(
+ 255,
+ 255,
+ 255
+ );
+ top: 0;
+}
+```
+
+## Optional secondary options
+
+### `indentInsideParens: "twice"|"once-at-root-twice-in-block"`
+
+By default, *one extra* indentation (of your specified type) is expected after newlines inside parentheses, and the closing parenthesis is expected to have no extra indentation.
+
+If you would like to change the quantity of extra indentation inside parentheses, use this option.
+
+`"twice"` means you expect two extra indentations (of your specified type) after newlines inside parentheses, and expect the closing parenthesis to have one extra indentation. For example:
+
+```css
+a {
+ color: rgb(
+ 255,
+ 255,
+ 255
+ );
+ top: 0;
+}
+```
+
+`"once-at-root-twice-in-block"` means two things: You want the behavior of `"once"`, as documented above, when the parenthetical expression is part of a node that is an immediate descendent of the root — i.e. not inside a block. And you want the behavior of `"twice"`, as documented above, when the parenthetical expression is part of a node that is inside a block. For example, with a SCSS map:
+
+```scss
+$foo: (
+ bar: 1,
+ baz: 2
+);
+
+a {
+ color: rgb(
+ 255,
+ 255,
+ 255
+ );
+ top: 0;
+}
+```
+
+### `indentClosingBrace: true|false`
+
+If `true`, the closing brace of a block (rule or at-rule) will be expected at the same indentation level as the block's inner nodes.
+
+For example, with `indentClosingBrace: true`.
+
+The following patterns are considered violations:
+
+```css
+a {
+ color: pink;
+}
+```
+
+```css
+@media print {
+ a {
+ color: pink;
+ }
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+ color: pink;
+ }
+```
+
+```css
+@media print {
+ a {
+ color: pink;
+ }
+ }
+```
+
+### `except: ["block", "param", "value"]`
+
+Do *not* indent for these things.
+
+For example, with `2`.
+
+The following patterns are considered violations:
+
+```css
+@media print,
+ (-webkit-min-device-pixel-ratio: 1.25),
+ (min-resolution: 120dpi) {
+ a {
+ background-position: top left,
+ top right;
+ }
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+@media print,
+(-webkit-min-device-pixel-ratio: 1.25),
+(min-resolution: 120dpi) {
+a {
+background-position: top left,
+top right;
+}
+}
+```
+
+### `ignore: ["inside-parens", "param", "value"]`
+
+#### `"inside-parens"`
+
+Ignore the indentation inside parentheses.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+ color: rgb(
+255,
+ 255,
+ 255
+ );
+ top: 0;
+}
+```
+
+#### `"param"`
+
+Ignore the indentation of at-rule params.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+@media print,
+ (-webkit-min-device-pixel-ratio: 1.25),
+ (min-resolution: 120dpi) {
+}
+```
+
+#### `"value"`
+
+Ignore the indentation of values.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+ background-position: top left,
+top right,
+ bottom left,
+ bottom right;
+}
+```