Support for github flavored markdown

[ghost]

Does mkdocs support Github Flavorded Markdown ?

https://help.github.com/articles/github-flavored-markdown

[edbrannin]

Mkdocs uses Python-Markdown, which has a variety of configurable extensions (plus third-party ones) that can be used to add different parts of GitHub-flavored markdown.

That said, the plumbing isn't quite in place yet to choose which extensions you want enabled. Right now only 4 extensions are enabled, but there's an open pull request (#74) to let us configure more extensions.

[d0ugal]

With #74 merged, I think you should look at third party extensions - hopefully something will provide the features you need. We don't want to implement Markdown extensions in mkdocs.

[edbrannin]

OTOH, it could be worth putting a section in the docs about which extensions exist that could bring it closer to GHFM parity.

[d0ugal]

Good point, that would be a nice pull request :) I'll open this back up for now with that in mind.

[d0ugal]

Looks like this might do the job, is it a Python-Markdown extension - https://github.com/dart-lang/py-gfm

I've not tried it and thus we can't endorse it on the documentation at the meoment.

[d0ugal]

I'm going to close this for now, a pull request to update the documentation could be useful but the short answer is that we can't support it even if it is provided by an external extension.