Confluence is pretty limited in terms of creating rich content, so I'm thinking about having the team put some effort into switching over to a Markdown-based system like GitHub Pages. Do you know of any pros and cons of GitHub pages for internal content of an organization vs Confluence?
I would consider using GitHub pages for internal static sites / Blog posts / API documentations.
If you have other documents with a lot of pictures (like architecture diagram, data flow diagram etc), I will still prefer confluence to GitHub pages because managing many images thru Github pages are a hassle. Its much easier with confluence-draw.io integration.