Fix and enforce proper list spacing in the docs
Problem to solve
When code blocks are nested improperly, it can cause subtle rendering issues (additional spaces) that could cause a code block to be invalid if copy and pasted. Additionally, syntax highlighting often doesn't work in diffs or raw file view, which can make issues inside the codeblocks harder to spot.
Proposal
We should fix as many incorrectly nested lists as we can, and then create and merge a vale rule to maintain consistency.