Settings

Theme

We need a new document markup language – here is why

freecodecamp.org

6 points by airnomad · 4 comments

Reader

4 threads
unlinked_dll

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

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

gyoza

looks cool -- I would use it.

daly

Latex.

Keyboard Shortcuts

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