h_a_r_u_k_i,
@h_a_r_u_k_i@programming.dev avatar

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

morrowind,
@morrowind@lemmy.ml avatar

Yeah asciidoc is really cool, I wish it was better supported.

Same with asciimath (are they related? )

funkless_eck,

doesn’t Markdown have a TOC function if you have at least 2 headings?

sbstp,

Unfortunately there’s no way to have a generated TOC within the page itself. It’s usually in a sidebar or something like that.

nothendev,

*org-mode

MonkderZweite,

Yes?

CubitOom,

Emacs gang here, coughing in org-mode.

nosurprises,

True that. A react library handles the rendering.

jdeath,

this is the way

  • All
  • Subscribed
  • Moderated
  • Favorites
  • random
  • uselessserver093
  • Food
  • aaaaaaacccccccce
  • [email protected]
  • test
  • CafeMeta
  • testmag
  • MUD
  • RhythmGameZone
  • RSS
  • dabs
  • Socialism
  • KbinCafe
  • TheResearchGuardian
  • Ask_kbincafe
  • oklahoma
  • feritale
  • SuperSentai
  • KamenRider
  • All magazines