misc. lintpickens

[sulrich]

• updates the markdownlint rules to flex on a few items. notably the following:

  • inline-html elements which are used for MkDocs stuff
  • line length for tables

• resolves a grip of linting issues inclusive of the relaxed linting rules for various elements.

• typos in the contribution guide

  a couple of comments here:

  • in some cases, there were very large (unreadable anyway) code blocks that were exceeding the line-length rules. i wrapped with wild abandon.
  • in other cases, there were long CLI examples that I reformatted to use \ continuation indicators as appropriate. in some cases this may not have been appropriate in which case, I added text explaining to the reader that the continuation marks were there for readability and they will need to modify this prior to using these in their configs. which seemed fine given that these were for involved command-line flags which need to be edited anyway.

[fredhsu]

lgtm