Do you tell your editor to hard-wrap each "block" of comments as you write (or edit) them, or is your editor configured to automatically hard-wrap all comments?
Either way, have you considered configuring your editor to soft-wrap comments while leaving your code alone? I'd say that's the most natural approach from a writing standpoint.
P.S. Every day, I use tools you've made. Keep making!
So I just tend to hard-wrap manually, out of habit, even when writing in a .txt file or an email. In fact, it's hard to stop myself from doing it in this textarea ;)
If you want to be an open-source hero -- go ahead and do it yourself ;) It's mainly a matter of taking the Markdown package, and the CoffeeScript package, and pasting the latter into the former, right where the syntax rule for "code block" goes.
I decided to take journo for a spin and wrote this up in hopes you'd continue to work on it.
I am a big fan of the goals of your work (CoffeeScript, Literate Programming).
Both projects make code easier to understand and more accessible to everyone.
I have the feeling that many of us forget about the value of this, after having invested many hours to understand complex syntaxes and general patterns.
From lowering the entry barrier and increasing efficiency, everybody will profit in the end.
About half way through realized it was the actual source file.
Simple example usage:
For vim-ers, check out vim-literate-coffeescript:
I've found a few additional mappings quite useful: https://gist.github.com/joyrexus/5112582
Now need to take a closer look at journo and docco integration.
So I tried it out and found it to be a really rewarding experience: https://github.com/JonAbrams/tomljs