this post was submitted on 12 Sep 2023
987 points (97.8% liked)
Programmer Humor
19623 readers
2560 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
- Keep content in english
- No advertisements
- Posts must be related to programming or programmer topics
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
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
doesn't Markdown have a TOC function if you have at least 2 headings?
Unfortunately there's no way to have a generated TOC within the page itself. It's usually in a sidebar or something like that.
Yeah asciidoc is really cool, I wish it was better supported.
Same with asciimath (are they related? )