• renzev@lemmy.worldOP
    link
    fedilink
    English
    arrow-up
    36
    ·
    10 months ago

    LaTeX is great, but I prefer Markdown for software documentation (bonus points if your flavor of markdown supports LaTeX-style math). Standard LaTeX is geared towards typesetting and formatting, which is great for reports and journals, but not so much for software documentation, so you end up with a lot of boilerplate. Markdown syntax is also more accessible to beginners, I feel. And if you have a really big project that requires features like cross-references, there’s things like myst markdown.

    • Anti-Face Weapon@lemmy.world
      link
      fedilink
      arrow-up
      9
      ·
      10 months ago

      Both are powerful tools, though with different strengths as you describe. I was thinking more with automation in mind. But regardless, anything is better than a discord server. Even .txt documentation!