OK. I'm tired of having to use Word, Pages, whatever the word processor is when it just seems to get in the way of getting words and information down.<p>I coding and website land I have pretty much transitioned to using markdown everywhere thanks to (joDoc and Jekyll, Django's markdown support is helpful too), but when it comes to writing doco for clients it's back to word processors.<p>How can I be free from this enslavement to GUI tools and use markdown and <insert your favorite text editor here, so as not to spark debate> to author these docs?
Here's an experiment we are running here for our technical documents.<p>We have an Etherpad server (<a href="http://etherpad.org/" rel="nofollow">http://etherpad.org/</a>) we heavily use, and we've used it to write some of our technical docs in Markdown. We use other pads to define HTML templates. Then, we have simple web app which merges a chosen HTML template with the Markdown content, which lets the user preview the rendered results before saving the final HTML output.<p>Advantages: you get all Etherpad's realtime collaboration goodness, automatic version control and revision history, the HTML templates can be edited simply (and restricted to editing by certain users), it's pretty quick to pick up.
Disadvantages: Etherpad is primarily text based so you're SOL if you need diagrams etc, slight complexity of the parts (templates, content, web app) to make it run.