The use case I was trying to fulfill:
- Have a reasonably unified authoring environment for the different content that I intend to write.
- Favor some sort of open source markup language over proprietary WYSIWYG editors. Candidates were Markdown, Latex, ReSTructured Text.
- Benefit from the version and change control that Github provides
- Be able to share the results with colleagues
- Be able to reuse the set up to document other projects in Github.
- Be able to easily embed rich math expressions and UML or similar diagrams
- Bonus:
- Be able to publish to Medium and other syndication platforms.
- Somewhat just for nostalgic reasons, be able to author Latex documents in the same environment and publish them.