<blockquote>
<p>We use <a href="https://rubygems.org/gems/redcarpet" rel="nofollow">https://rubygems.org/gems/redcarpet</a> for our markdown formatting so any issues with it are largely outside our control.</p>
</blockquote>
<p>Unfortunately redcarpet appears to be largely unmaintained, and it contains multiple unfixed bugs regarding parsing markdown lists (e.g. <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="310228744" data-permission-text="Issue title is private" data-url="https://github.com/vmg/redcarpet/issues/655" data-hovercard-type="issue" data-hovercard-url="/vmg/redcarpet/issues/655/hovercard" href="https://github.com/vmg/redcarpet/issues/655">vmg/redcarpet#655</a> and <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="245061444" data-permission-text="Issue title is private" data-url="https://github.com/vmg/redcarpet/issues/623" data-hovercard-type="issue" data-hovercard-url="/vmg/redcarpet/issues/623/hovercard" href="https://github.com/vmg/redcarpet/issues/623">vmg/redcarpet#623</a>).</p>
<blockquote>
<p>Also everybody knows that there is no "one" markdown - what we link to is just a convenience for some hints because there is no definitive spec.</p>
</blockquote>
<p>Indeed, but there's a difference between different interpretations of markdown, and bugs in the parsing library. For example, the gist posted by <a class="user-mention" data-hovercard-type="user" data-hovercard-url="/hovercards?user_id=5958794" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/nachanon">@nachanon</a> renders fine with the original markdown, and also the commonmark parser at <a href="https://spec.commonmark.org/dingus/" rel="nofollow">https://spec.commonmark.org/dingus/</a> - so I think that our broken parsing is something that we should try to fix.</p>
<p>Jekyll (and therefore github pages) no longer use redcarpet but instead use <a href="https://github.com/gettalong/kramdown">kramdown</a> as their default markdown parser. Perhaps we could do the same?</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/openstreetmap/openstreetmap-website/issues/2103#issuecomment-452621142">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABWnLWqfxXXEAn6BEcHTpgszP6eAgoFvks5vBa_TgaJpZM4Z283O">mute the thread</a>.<img src="https://github.com/notifications/beacon/ABWnLY1PwyhFpCqFv5zFGKkaYCs9y05fks5vBa_TgaJpZM4Z283O.gif" height="1" width="1" alt="" /></p>
<script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/openstreetmap/openstreetmap-website","title":"openstreetmap/openstreetmap-website","subtitle":"GitHub repository","main_image_url":"https://github.githubassets.com/images/email/message_cards/header.png","avatar_image_url":"https://github.githubassets.com/images/email/message_cards/avatar.png","action":{"name":"Open in GitHub","url":"https://github.com/openstreetmap/openstreetmap-website"}},"updates":{"snippets":[{"icon":"PERSON","message":"@gravitystorm in #2103: \u003e We use https://rubygems.org/gems/redcarpet for our markdown formatting so any issues with it are largely outside our control.\r\n\r\nUnfortunately redcarpet appears to be largely unmaintained, and it contains multiple unfixed bugs regarding parsing markdown lists (e.g. https://github.com/vmg/redcarpet/issues/655 and https://github.com/vmg/redcarpet/issues/623).\r\n\r\n\u003e Also everybody knows that there is no \"one\" markdown - what we link to is just a convenience for some hints because there is no definitive spec.\r\n\r\nIndeed, but there's a difference between different interpretations of markdown, and bugs in the parsing library. For example, the gist posted by @nachanon renders fine with the original markdown, and also the commonmark parser at https://spec.commonmark.org/dingus/ - so I think that our broken parsing is something that we should try to fix.\r\n\r\nJekyll (and therefore github pages) no longer use redcarpet but instead use [kramdown](https://github.com/gettalong/kramdown) as their default markdown parser. Perhaps we could do the same?"}],"action":{"name":"View Issue","url":"https://github.com/openstreetmap/openstreetmap-website/issues/2103#issuecomment-452621142"}}}</script>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/openstreetmap/openstreetmap-website/issues/2103#issuecomment-452621142",
"url": "https://github.com/openstreetmap/openstreetmap-website/issues/2103#issuecomment-452621142",
"name": "View Issue"
},
"description": "View this Issue on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>