Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

The MyST flavor of markdown is not the same as GitHub flavor, especially about embedding highlighted/replaced content.

If you want an example of this breakage, try embedding a Mermaid format diagram in both of them.



I’m well aware. It’s also a one line change to the myst parser to make that work.

In any case, it’s because a myst code block with curly brackets is really a sphinx directive.

That said, they should support the non-directive version, similar to GFM, but would need to embed it. Compared to GFM, though, a plug-in can be added to support plantUML and there’s even crusty ones for graphviz.

GFM version is also not particularly flexible for large diagrams




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: