News for hackers. Stuff that matters.

A comment on Markdown Is Holding You Back. Parent comment

Re:Markdown Is Holding You Back by dragonwriter on Saturday November 22, 2025 @05:15PM (#46018775)
> If I'm writing developer documentation I'm not writing it for a machine. And if the aim here is to expose it to a LLM, then the LLM needs to get smarter about semantics, not force us back to formats that are more technically complex to write and maintain

AsciiDoc is much better than Markdown for docs intended for humans that are more than short, README type of documents. Any advantage it has for documents intended for LLMs is a side effect of that.

[ Parent | on HN ]
Re:Markdown Is Holding You Back by zihotki on Saturday November 22, 2025 @05:21PM (#46018820)
Many consider AsciiDoc being too complex.
[ Parent | on HN ]
Re:Markdown Is Holding You Back by doublebind on Sunday November 23, 2025 @01:46PM (#46026169)
The history of tech is full of "X is better than Y. We should use X", only for X to die. It doesn't matter what is better; it matters what is used. For better or worse, Markdown is what is used.
[ Parent | on HN ]