Docs: try using GH-flavoured markdown with pandoc

[GPMueller]

They claim it is supported, so maybe things will work better now: https://pandoc.org/