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

As I said on Twitter, this was a great article, but needs to mention Jekyll, which was one of the OG static site generators. There are others such as eleventy as well.

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?



The creator of Pandoc is creating a markup language worth looking at: https://djot.net/


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.


Two things on my radar to check out are MyST markdown and quarto.




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

Search: