I recently came across this best practice regarding writing Markdown: https://sembr.org/ I think we should add that as a recommendation under "tips" at https://github.com/openEOPlatform/documentation/blob/main/DEVELOPMENT.md