perl snippets in md and readthedocs

[stdweird]

Lookup the best way to insert code snippets with syntax highlighting that ideally works with github markdown and readthedocs.

[jrha]

I think we've solved this now, but will double check.