We have qlhelp and md files as documentation for rules. There should only be the qlhelp type. Documentation in markdown is for additional, not rule-specific information.
Or I guess so, will need to read GitHub docs to find proper way of documenting rules.