from Hacker News

We need a new document markup language – here is why

by airnomad on 1/21/20, 9:03 PM with 4 comments

• by unlinked_dll on 1/22/20, 5:09 AM

  Bit weird to say you're going to talk about syntax and then complain about syntax highlighting in markdown, which is a rendering problem.

  Markdown is perfectly well suited for whatever documentation needs you have imo/e. If you need complexities not standard to CommonMark you tweak your renderer or inject some html as a preprocessing step, for example adding mathjax for formulae or say, a syntax highlighter.

  Markdown is simple enough to use and simple enough to extend for your deployment. Haven't had any issues with very complex docs started in MD.

• by alexellisuk on 1/21/20, 9:43 PM

  They all look horrible for documentation apart from YAML, which IMHO is a suitable compromise with add-ons for tables, etc.

• by gyoza on 1/21/20, 9:23 PM

  looks cool -- I would use it.

• by daly on 1/21/20, 11:33 PM

  Latex.