This is another of those sad cases where worse is better. AsciiDoc, and perhaps ... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		slowmovintarget on March 24, 2020 \| parent \| context \| favorite \| on: Don't write documentation in Markdown This is another of those sad cases where worse is better. AsciiDoc, and perhaps RST, are superficially better by measures of specification-completeness and uniform handling of corner cases. Markdown is used everywhere, so it "won". Better doc in a "worse" format than no doc at all.

lmm on March 24, 2020 [–]

RST is clunky to write. Markdown "won" because it solves the most important part of the problem - humans feel comfortable writing it.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact