News for hackers. Stuff that matters.
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-... by spaniard89277 on Friday November 04, 2022 @01:26PM (#33470447)
I would say HTML?
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-... by MrVandemar on Friday November 04, 2022 @07:05PM (#33475283)
I don't know why people are so keen to put distance between themselves and HTML. HTML is a rich, expressive markup language with strong accessibility features that is also consistent and simple.

I write in HTML the way some people write in Markdown using the abbreviated (but valid) syntax.

<!DOCTYPE html> <title>The Great Novel of All Time

<h1>Chapter One</h1>

<p>It was a dark and stormy night.

<p>Suddenly a shot rang out!

<p>A door slammed. The maid screamed.

If you avoid closing things that don't need to be closed, and use whitespace (and a syntax-highlighting editor) it's easy to write and easy to eye-parse.

No includes though.

Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-... by tadfisher on Saturday November 05, 2022 @03:27AM (#33478842)
Whitespace collapsing just sucks, though. The SGML roots hamper HTML's ergonomics for human writers.
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-... by spaniard89277 on Sunday November 06, 2022 @05:52AM (#33491245)
* {white-space: pre-wrap;} or pre-line, depending on what you want. Done.