docs: fix MD031 markdown lint

[xtqqczze]

MD031/blanks-around-fences : Fenced code blocks should be surrounded by blank lines

[PhilipMetzger]

if the project adopts a MD linter we first should find consensus on that before starting to apply it.

[martinvonz]

I agree. But markdownlint seems to not be a formatters but a linter. We can adopt both a formatter and markdownlint, I suppose. markdownlint presumably doesn't make suggestions that would go against any particular formatter.

[steveklabnik]

As a random aside, I've always written Markdown in this way, I suspect a lot of implementations these days would render without the spaces, but in the earlier days, many didn't.

I have no opinions on markdown linters or formatters, I haven't really used any myself.

[martinvonz]

I have no objection to the changes here. It seems fine to even include the .markdownlint.json* files. That doesn't mean that we have agreed on using using markdownlint IMO, it's just there for convenience for those who do. What do you think, @PhilipMetzger ?

[PhilipMetzger]

What do you think, @PhilipMetzger ?

I'm fine with the change, but I'd prefer to keep the configuration files out of the repo until there's some consensus around the tooling we want to use for markdown (linters and formatting).

[xtqqczze]

7644a9b removed the .markdownlint.jsonc and .markdownlint.json files