metacpan-web
metacpan-web copied to clipboard
Markdown not rendering correctly
Please compare
https://github.com/marioroy/mce-perl/blob/master/README.md
vs
https://metacpan.org/source/MARIOROY/MCE-1.872/README.md
The 3x ` seem to have problems.
So, issues with code fencing.
Looks like. Of course it may not be metacpan's bug as such, but rather a library
It's not strictly speaking a bug. MetaCPAN is using MultiMarkdown to render the markdown, which adds some extensions over the original Markdown format. GitHub uses its own set of extensions over the original Markdown.
It would be a good idea to switch to something CommonMark compatible.
I also see that bulleted (unordered) lists in my markdown are rendered without list markers or inter-item vertical space which makes a list of long items just look like indented prose. See particularly the CODE section in this document.
Source: CONTRIBUTING.md Rendered at metacpan Rendered at gitlab
(let me know if you consider this a separate issue and I'll raise one)
That is an entirely different issue, because the style rules for markdown don't match what you want.
It would be a good idea to switch to something CommonMark compatible.
Are there suggestions on a module we could switch to or does it not yet exist?
FWIW CommonMark is a module on cpan
https://metacpan.org/pod/distribution/CommonMark/lib/CommonMark.pod