> it's hard to know when the example ends and real code begins (indent is not > that clear)
Agreed. To partly mitigate this, I decided that the initial indent of runnableExamples in my code should be 4 spaces instead of two. (I've tried even larger indentations, but it becomes awkward very soon) See [here](https://github.com/narimiran/itertools/blob/master/src/itertools.nim) how it looks like. Syntax highlighting is still distracting, but at least it is somewhat easier to see when the real code begins.
