Just closing the loop on this topic. The submitted PR was closed after some discussion.
https://github.com/discourse/discourse_api_docs/pull/25
but I did follow it up with a commit that fixed the newline issues:
https://github.com/discourse/discourse_api_docs/commit/c5f7b9e3c8b3791b4cdc1c0f16add98cfd9f9f37
Also, just wanted to say that we are currently in the process of converting the api docs to be more integrated with the discourse code base by using a tool called rswag, that can auto generate the OpenAPI json spec file. I know there are some linting issues with the current docs, but I feel like our energy would be best spent investing in completing the transition to rswag which will help us address many of these issues.