Why are READMEs rendered differently in NPM registry vs. Crates registry for packages?

[BA-CalderonMorales]

Genuinely curious here. Specifically the annotations below. Figured this could be something easy to fix.

Thought it was odd that we can't see the following properly formatted in NPM Registry (maybe it's just my laptop?).

Note

Highlights information that users should take into account, even when skimming.

Important

Crucial information necessary for users to succeed.

Warning

Critical content demanding immediate user attention due to potential risks.

Tip

Helpful advice for doing things better or more easily.
Tip

Examples taken from this helpful gist

GitHub and Crates both handle this rendering. Would like to know why NPM Registry doesn't handle this.

Hoping for clarity here. Was going to try to put up a PR myself, however, I'm not even sure where to start looking for this small change to be applied. Hoping to get some help from maintainers.

• terminal-jarvis: npm
• terminal-jarvis: crate
• terminal-jarvis: github

See differences below (expand/collapse dropdowns for ease of reference):

NPM Registry (README.md)

Crates Registry (README.md)

GitHub (README.md)

Hoping to have a genuine discussion about this. If it's intentional, then maybe a reference to a specific piece of docs would be nice to add to this question and left up in case others run into this.

[bcomnes]

A likely factor is that annotations were a late addition to GFM so when GFM was implemented on npm, they didn't exist yet. Why they haven't been added since is likely because not much is being done overall on the npm website since the gh acquisition.

[BA-CalderonMorales]

I’ll keep digging until someone gets around to this.

If I find something, I’ll try to put up a PR.

Rn though, feels like a needle in a haystack.

I managed to get the npm cli project pulled down and got all tests to pass. Working on best way to approach this patch.

However, I want to make sure ai am working on the right repo before I start to actually dig.

[thescientist13]

These annotations are only in Beta on the GitHub side, FYI - https://github.com/orgs/community/discussions/16925

[BA-CalderonMorales]

@thescientist13 so would you consider this a nice to have since its only in Beta?

I’d prefer if: GitHub, NPM and Crates looked a bit uniform.

I don’t want to update my GitHub README if it looks like NPM is the odd one out.

Thoughts?

[thescientist13]

I was just providing some context on that annotations feature. (I'm not on the npm team, FYI)

[BA-CalderonMorales]

@thescientist13 couldn’t tell if you were or weren’t man. Don’t want to guess on here 😅

Will try to start digging into this.

Appreciate the context!

Hopefully we can get some guidance on this.