Resolve markdown warnings

[kianmeng]

These resolves warnings as suggested by markdownlint which includes:

• MD002 First header should be a top level header
• MD014 Dollar signs used before commands without showing output
• MD022 Headers should be surrounded by blank lines
• MD033 Inline HTML
• MD013 Line length