Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Pretty sure that markdown wasn't imagined for that purpose, how would it even work?

Markdown for comments in config files? Absolutely.



The autorest project uses this actually.

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...




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: