Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-...
by macintux on Friday November 04, 2022 @01:37PM
(#33470684)
The creator of Pandoc is creating a markup language worth looking at: https://djot.net/
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-...
by fluidcruft on Friday November 04, 2022 @02:03PM
(#33471193)
Two things on my radar to check out are MyST markdown and quarto.
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-...
by subpixel on Friday November 04, 2022 @03:14PM
(#33472200)
Stripe’s Markdoc (markdoc.dev) is very promising.
Anything AsciiDoc can do, Markdoc can be extended to do, from variables through includes.
React or HTML output. AST transforms or functions. Upcoming editor support etc.
The community isn’t there yet but I predict it will show up.
I was kinda shocked that asciidoc came up as the recommended documentation solution; we use it and were looking to possibly make a move because of some of the warts (includes are great, but then make updating doc more complex, no one line ifdef check, feels a bit aged).
Anyone have any other suggestions we should look at?