My favorite writing tool is Scrivener. I wrote the Learning MCollective book for O’Reilly Media entirely in Scrivener. I was afraid this wouldn’t work very well, but it ended up working just great.

To do this, I created a Scrivener compile format which set up chapter headings correctly with a link target above them as recommended. Then I wrote some scripts to process the output from Scrivener compile to make AsciiDoc in the flavor that O’Reilly wanted.

I have released my Scrivener compile settings and scripts so that others can use them should they want to produce asciidoc from Scrivener. They are open source under an Apache license at https://github.com/jorhett/scrivener-asciidoc.