that URL hacking works

perl -0777 -i -pe 's|^(.*)\n-{3,}$|## $1|gm' `find . -name '*.md'`
perl -0777 -i -pe 's|^(.*)\n={3,}$|# $1|gm' `find . -name '*.md'`

Large scale clean up of markdown code (in almost all files) to conform to markdown conventions that I observed to be used consistently in the official CiviCRM User Guide. These convensions are now documented in the markdownrules.md file