• toastal@lemmy.ml
    ·
    3 months ago

    Markdown is trash. It almost always comes in a fork that is naturally incompatible with other forks & never has the features you need for blogging or technical writing (leading to abuse of the limited features, unsemantic markup output, and/or embedding HTML which is both ugly & also ruining portability to non-HTML targets). This leaves you locked into some specific tool’s forked implementation & never looks good in other contexts. Markdown was also never the only or best option for lightweight markup at any time.

    • toastal@lemmy.ml
      ·
      3 months ago

      Downvotes here showing it’s controversial, but I am willing to bet these folk have never given AsciiDoc, reStructuredText, & LaTeX a spin in comparison (for ‘real world’ documentation, etc. with multiple output targets) to actually know what they are talking about 😅

    • fossphi@lemm.ee
      ·
      3 months ago

      Nothing beats org mode syntax for markup. You don't have to use emacs, but syntactically, org is so much more convenient, consistent and easy.

      https://karl-voit.at/2017/09/23/orgmode-as-markup-only/

      • toastal@lemmy.ml
        ·
        3 months ago

        Org mode is fine, better than Markdown, but still wouldn’t be my first choice for technical writing. I will still respect you for using it tho. 😄