Fix markdown errors in README.md

[LilithHafner]

The cross-page link is broken. Rather than fix it, I removed it because the API section is typically already on-screen when folks see this link.

The note syntax is not supported on github so I switched it to standard markdown.