docs: improve generated markdown.