Comment on Markdown everywhere
h_a_r_u_k_i@programming.dev 1 year ago
Markdown is good. I use it when working in the company since the format is ubiquitous. I do writing my blog posts with Markdown (Hugo for the curious).
But personally, or working with a bit more niche team, for writing personal documentation I prefer Asciidoc [0]. It has better syntax and have some nice functionalities like Table of Contents.
For personal notes, nothing can surpass Org Mode [1].
[0] asciidoc.org [1] orgmode.org
funkless_eck@sh.itjust.works 1 year ago
doesn’t Markdown have a TOC function if you have at least 2 headings?
sbstp@programming.dev 1 year ago
Unfortunately there’s no way to have a generated TOC within the page itself. It’s usually in a sidebar or something like that.