i've been using apiary this week and it's been absolutely fantastic so far. Markdown goes in, API docs + mock live API comes out, even syncs with github.
it's definitely a great tool, it's really useful being able to chop and change in the early stages of designing an API without being committed in the code.