Adjusting text around markdown

For #910, I wanted to make clear the concept that `docgen` supports `markdown`, a generic markup syntax, and that it's not specific to dart. Linking to the docgen article and the markdown package should help users too. Should more change here?