I really love this post. I am glad that someone is really thinking about how to improve the publishing workflow and toolchain. I really want to try this process now :). I am on the academic side, so collaboration and writing complex (and not so complex) articles is such a pain especially when formatting figures and equations. I have been using Latex and Markdown for a while, but perhaps it is time to give Asciidoc a chance. Cyrille Rossant also has some nice insights into this process as well http://cyrille.rossant.net/writing-ipython-cookbook/ .