• haruki@programming.dev
    link
    fedilink
    arrow-up
    29
    ·
    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

      • sbstp@programming.dev
        link
        fedilink
        arrow-up
        3
        ·
        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.

    • morrowind
      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? )