Pretty sure that markdown wasn't imagined for that purpose, how would it even work?
Markdown for comments in config files? Absolutely.
Markdown for comments in config files? Absolutely.
It works by embedding yaml code blocks into a markdown file.
It’s actually not completely awful and has proven somewhat useful to have a configuration clearly documented within the config.
https://github.com/Azure/autorest/blob/main/docs/generate/re...