Settings

Theme

We need a new document markup language – here is why

freecodecamp.org

6 points by airnomad 6 years ago · 4 comments

Reader

unlinked_dll 6 years ago

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.

alexellisuk 6 years ago

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

gyoza 6 years ago

looks cool -- I would use it.

daly 6 years ago

Latex.

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection