• haruki@programming.dev
    link
    fedilink
    arrow-up
    25
    ·
    edit-2
    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] https://asciidoc.org

    [1] https://orgmode.org

    • morrowind@lemmy.ml
      link
      fedilink
      arrow-up
      1
      ·
      1 year ago

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

      Same with asciimath (are they related? )