4 ms·
This article doesnt consider Typst, which IMO ought to be the first port of call if Markdown isnt sufficient for your needs.
by nicoburns 11mo ago
This article doesnt consider Typst, which IMO ought to be the first port of call if Markdown isnt sufficient for your needs.
- perlgeek 11mo agoI've used typst for generating PDFs before, how good is its HTML output?
- undeveloper 11mo agoit looks like typst's html output is under construction [1]. 1: https://typst.app/docs/reference/html/ https://typst.app/docs/reference/html/
- tefkah 11mo agotypst is great, but there are many many steps between “markdown isn’t sufficient” and reaching for typst. 1. typst only really has pdf output at the moment 2. so much less tooling available (linters, site builders, converters etc) 3. much less of a markup format, extremely tightly coupled to a specific tool (typst compiler) again, love typst, but it has (atm) so much fewer applications
- tcfhgj 11mo agoTypst has already experimental HTML output and it specifically has a markup mode (default mode). Conceptually Typst is a superset of a Markdown with a slightly different syntax (e.g. = instead of # for headers)
- lenkite 11mo agoI guess we need to wait until Typst is natively supported by Github.
- WhyNotHugo 11mo agoI think Typst looks really interesting for some scenarios, but inadequate for others. I like RST a lot for Python documentation, because of all the directives for types, admonitions, and lots of domain-specific stuff. I wouldn't use RST if I'm writing a book, or a research paper. In the same way, Typst looks like a great candidate for those last examples, but is likely unsuitable for documenting a library written in Python.
- tcfhgj 11mo ago> In the same way, Typst looks like a great candidate for those last examples, but is likely unsuitable for documenting a library written in Python. why though? Would you categorize Markdown as unsuitable as well? if so, why?