← Back to context

Comment by gavinhoward

3 years ago

I am someone who has decided to go all-in on djot for my software.

Personally, I care about the edge cases. I also don't care about multiple parsers because I want to write my own. (I currently depend on Sphinx, Breathe, and MyST, which are heavy dependencies.) And I don't store my code on GitHub because of Copilot and because of [1].

I decided to go all-in on djot for several reasons:

* I can write my own parser.

* djot can target any format, which means I can use the same docs to generate manpages, a docs website like [2], and perhaps PDF's if my docs include something like the Rust Book.

* djot's extension story [3] is the best of any format, and I need extensions that don't exist in any format for things like EBNF in a specification.

That said, I think you are correct that this will not take off as much as CommonMark has. I guess I was just sharing that I don't care and why.

[1]: https://gavinhoward.com/2020/04/i-am-moving-away-from-github...

[2]: https://docs.yzena.com/

[3]: https://github.com/jgm/djot/discussions/77