JSON is a different kind of yuck to have to author by hand, especially in the volume an api spec tends to be.
Either don't write it by hand, i.e. use a generator for the structured format, as the comments advocate for and article is about.
Or, just say you'll never have a spec.