Make line highlighting and numbering straightforward and documented

[szotsaki]

• [X] bugfix
• [X] feature
• [ ] code refactor
• [ ] test update
• [X] docs update
• [ ] chore update

Motivation / Use-Case

Line numbering and highlighting in the ``` block was not straightforward or documented.