Cleanup docs

[theLee3]

Clean up docs, where possible, in the following ways:

• Update pub badge to correct package (assuming this was a mistake...)
• Add alt text to image tags
• Reduce Markdown formatting warnings where possible