notes/node_modules/stylelint/lib/rules/rule-nested-empty-line-before/README.md

# rule-nested-empty-line-before

***Deprecated: instead use the [rule-empty-line-before](../rule-empty-line-before/README.md).***

Require or disallow an empty line before nested rules.

```css
@media {
       /* ← */
  a {} /* ↑ */
}      /* ↑ */
/**       ↑
 * This line */
```

## Options

`string`: `"always"|"never"|"always-multi-line"|"never-multi-line"`

### `"always"`

There *must always* be an empty line before rules.

The following patterns are considered warnings:

```css
@media { a {} }
```

```css
@media {
  a {}
}
```

The following patterns are *not* considered warnings:

```css
@media {

  a {}
}
```

### `"never"`

There *must never* be an empty line before rules.

The following patterns are considered warnings:

```css
@media { a {} }
```

```css
@media {

  a {}
}
```

The following patterns are *not* considered warnings:

```css
@media {
  a {}
}
```

### `"always-multi-line"`

There *must always* be an empty line before multi-line rules.

The following patterns are considered warnings:

```css
@media {
  a {
    color: pink;
    top: 0;
  }
}
```

The following patterns are *not* considered warnings:

```css
@media {

  a {
    color: pink;
    top: 0;
  }
}
```

### `"never-multi-line"`

There *must never* be an empty line before multi-line rules.

The following patterns are considered warnings:

```css
@media {

  a {
    color: pink;
    top: 0;
  }
}
```

The following patterns are *not* considered warnings:

```css
@media {
  a {
    color: pink;
    top: 0;
  }
}
```

## Optional secondary options

### `except: ["first-nested"]`

Reverse the primary option if the rule is the first in a block.

For example, with `"always"`:

The following patterns are considered warnings:

```css
@media {

  a {}

  b {}

  c {}
}
```

The following patterns are *not* considered warnings:

```css
@media {
  a {}

  b {}

  c {}
}
```

### `except: ["after-rule"]`

Reverse the primary option if the rule comes after another rule.

For example, with `"always"`:

The following patterns are considered warnings:

```css
@media {
  color: red;
  a {}
  b {}
  c {}
}
```

The following patterns are *not* considered warnings:

```css
@media {
  color: red;

  a {}
  b {}
  c {}
}
```

### `ignore: ["after-comment"]`

Ignore rules that come after a comment.

The following patterns are *not* considered warnings:

```css
@media {
  /* comment */
  a {}
}
```

```css
@media {
  /* comment */

  a {}
}
```