Re: [csswg-drafts] Build markdown documents to HTML in the CI workflow (#13432)

Not to beat this into the ground, but for the record here: After looking into `cmark-gfm` further, I find it doesn’t handle the GH > [!NOTE] etc admonitions stuff (with apparently are officially called _“alerts”_.

So there’d be zero point in using `cmark-gfm` rather than Python-Markdown.

But there is one thing that _does_ handle those GFM “alerts”: The GH API `https://api.github.com/markdown` endpoint.

So, if at some point later y’all _do_ find a need to use GFM features that Python-Markdown doesn’t support, then you could switch the build to using that GH API markdown endpoint. The main downside would be the obvious one: That it would requiring having  network connection / being online. There’s also the fact that the API is rate limited, and the fact that the API requests are limited to the source markdown files needing to be 400KB or less.

The rate limit and size limit would not be problems here in practice. But I reckon the requirement to have to be online could be a PITA. And it seems like there’d be no point in introducing an extra PITA for no real additional benefit.

So yeah, I’d imagine all y’all and your contributors would agree that relying on Python-Markdown seems fine.

-- 
GitHub Notification of comment by sideshowbarker
Please view or discuss this issue at https://github.com/w3c/csswg-drafts/pull/13432#issuecomment-3845479856 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 4 February 2026 05:42:01 UTC