The more flexibility a language gives you in the order you place your code, the better it is for literate programming. If you haven't seen it yet, check out th

The more flexibility a language gives you in the order you place your code, the better it is for literate programming. If you haven't seen it yet, check out the source code to coffeescript. Here is the source file: https://github.com/jashkenas/coffeescript/blob/master/src/grammar.coffee https://github.com/jashkenas/coffeescript/blob/master/src/gr... Here is a nicely rendered version of the same file: http://coffeescript.org/documentation/docs/grammar.html http://coffeescript.org/documentation/docs/grammar.html Also see literate coffeescript, a mode that seamlessly integrates markdown. I'd give up vim for a environment that lets me embed images, embed SVG diagrams, use those SVG diagrams at compile time to generate code, etc.