Ask HN: How do you write documentation for your public APIs?

Do you know of any good programs? Do you simply use a Markdown or RST document? Or do you know of something even better?

Thanks!