Edits and fixes based on review.

Docker-DCO-1.1-Signed-off-by: Fred Lifton <fred.lifton@docker.com> (github: fredlf)
Well, it is an *incorrect* statement in the official docs then, given the lack of GitHub flavored MD support unless of course there is another tool rendering the files.

MkDocs does **NOT** support GitHub flavored MD.