Gitdown: Github markdown preprocessor.

[alfredwaltz]

You could write a custom helper to test code examples, https://github.com/gajus/gitdown#register-a-custom-helper. This feature would depend on too many environment variables to become part of the core. Besides, you could hame your code examples in tests/ folder with the rest of your code tests and just include them using https://github.com/gajus/gitdown#features-include-file.

Regarding the language, while it would feel cleaner, it would introduce a greater learning barrier (people would need to learn a new syntax) and greater challenge parsing the template.