Markdown - crccheck/crccheck.github.io GitHub Wiki

These are the things I consider when deciding which code block style to use.

• "```javascript" – This style has the most readability in github, and the worst readability in plaintext. I only use it for larger blobs that actually have code
• "```" – I use this style for when I need to easily copy paste in code to Markdown, because no one has time to change indention levels
• 4 spaces – I use this style when I want text to be legible in plaintext, and for short blocks where "```" is a significant portion of the line count of the block

In this case, adding "```" would increase the line count 200% and add no additional readability, and the command does not need constant copy-pasting from elsewhere to be maintained.

Headings

Update I use Prettier to format Markdown now and I just let it do what it wants, which is ## style headers.

Related, I prefer underscore headings "=======" "--------" for when Markdown should be legible in plaintext. I don't like how it adds another line, but it makes scanning raw Markdown so much faster. I use "#" "##" style in wikis, when I know only the rendered version is actually used, and as a deliberate smell that I'm being lazy. For example, this wiki page.