Fix formatting issues and inconsistencies

* Specify language in code blocks
* Use nicer markdown syntax
* Added missing semicolons to code samples
* Fixed inconsistent code style in code samples
* Fix broken links
this is not a proper markdown header, maybe we should use more something like `## Open a page` for 2nd level headers?