It would be useful to have at generation time a set of warnings when markdown is not properly linted. Similar to the features provided by: https://github.com/bflad/tfproviderdocs