I think a good start would be to write a parser for the existing markdown into XML, and try and parse it into sections like description / parameters / examples etc. Once we've got that it will show us what extra information or detail is missing (or rather would be preferable) to make translation into other formats as painless as possible.
Then it's either a case of adding more structure or detail into the markdown, or having an extra step where we add more detail at the XML stage. But that extra work would make it simpler when converting into other doc formats. I'll make an XML parser and see what comes of it. I'm also interested in what the process is for making 'help' for the other IDEs. I had a quick peek at the Coda help and it looks like it's just a function list - would love to know if I've got the right impression.
