I sometimes dream of a source code editor that would allow inline diagrams and nicele rendered documentation and or equations. This could apply to any language that has support for multiline comments.
For example, a code like this, (where md stands for markdown)
/*md
Square value of *any* type