Refactor writing-your-docs.md (#1392)
Present the sections in a logical manner: 1. File Layout (where to save documents) * Configure Navigation... 2. Writing with Markdown * Supported extensions... Added documentation for all included extensions. Also added some basic information about Markdown; pointing to the implementation and rules. Fixes #1385, fixes #316, and fixes #1172.