Normal markdown links? [ link text ]( href ). Unfortunately there doesn't seem to be a way to use the link as the text, I guess we could add link detection to the parser? Or maybe just [ link ] which the dart doc parser does.

As a side note: perhaps we should use `@php` or `@platform(php)` tags to denote platform specific notes? We could then filter them when you choose platform in the dropdown.