rewritte old proposal api documentation to markdown

`<br>` swallowed. Apparently enclosing in backticks can prevent that.