Markdown linter (#1309) (#2526) (#2527)

* Add markdown linting

- add linter default rules
- adapt rules to current code
- fix the code for linting to pass
- add CI check

fix #1243

* Fix markdown for Substrate
* Fix tooling install
* Fix workflow
* Add documentation
* Remove trailing spaces
* Update .github/.markdownlint.yaml


* Fix mangled markdown/lists
* Fix captalization issues on known words

(cherry picked from commit a30092ab42c74c8a4d4c6ce8ac2b0e860749bb46)

Co-authored-by: Chevdor <[email protected]>