3 ms·
Hopefully there’s some overlap with MyST - the markdown format from sphinx. That format is mostly reasonable in terms of extending markdown by enabling sphinx/r
by prpl 4y ago
Hopefully there’s some overlap with MyST - the markdown format from sphinx. That format is mostly reasonable in terms of extending markdown by enabling sphinx/reST directives.
- zdw 4y agoThe 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.
- prpl 4y agoI’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