News for hackers. Stuff that matters.
Re:If it is worth keeping, save it in Markdown by out_of_protocol on Wednesday February 26, 2025 @03:41PM (#43187969)
Mermaid charts! Supported by github and very readable as plaintext

https://github.blog/developer-skills/github/include-diagrams...

Re:If it is worth keeping, save it in Markdown by josephg on Wednesday February 26, 2025 @11:11PM (#43191276)
I put that in the "hacky workarounds" category.

Does it work at all? Yeah. Does it work in my markdown editor? Probably not. Does it work in my markdown renderer? I don't know. Which version of Mermaid does it work with? Probably a different version of mermaid on every platform. Can I save my mermaid diagram to a file and link it instead of inlining the mermaid diagram inline? Who knows. Flip a coin everywhere mermaid is supported.

I tried pushing a markdown renderer to the limits once - only to find out that the markdown renderer I was using doesn't correctly implement commonmark, and my markdown file breaks with every other markdown renderer I've tried it with. To say nothing of the custom extensions I tried to use.

At this stage I'd rather keep my markdown files simple, and use something better for real documents. Something like typst.