MD031 - Code blocks need blank lines around them¶

Aliases: blanks-around-fences

What this rule does¶

Ensures code blocks (```) have blank lines before and after them for proper spacing.

Readability: Blank lines visually separate code from surrounding text
Rendering: Some Markdown processors require blank lines for proper code block display
Consistency: Uniform spacing makes documents look professional

Here's some text explaining the code.

```python
def hello():
    print("Hello, world!")
```

And here's more text after the code.

Here's some text explaining the code.
```python
def hello():
    print("Hello, world!")
```
And here's more text after the code.

Here's some text explaining the code.

```python
def hello():
    print("Hello, world!")
```

And here's more text after the code.

[MD031]
list-items = true  # Also require blank lines in lists (default: true)

When list-items is true (default):

1. First item

   ```python
   code_in_list()
   ```

1. Second item

When list-items is false:

1. First item
   ```python
   code_in_list()
   ```

1. Second item

This rule automatically adds blank lines: