991
Markdown everywhere (lemmy.world)
you are viewing a single comment's thread
view the rest of the comments
[-] h_a_r_u_k_i@programming.dev 30 points 1 year ago* (last edited 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

[-] funkless_eck@sh.itjust.works 5 points 1 year ago

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

[-] sbstp@programming.dev 3 points 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@lemmy.ml 1 points 1 year ago

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

Same with asciimath (are they related? )

this post was submitted on 12 Sep 2023
991 points (97.8% liked)

Programmer Humor

19544 readers
496 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 1 year ago
MODERATORS