Programmer Humor

18255 readers

643 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

[email protected]

983

Markdown everywhere (lemmy.world)

submitted 9 months ago by mod_pp to c/[email protected]

102 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[–] [email protected] 29 points 9 months ago* (last edited 9 months ago) (2 children)

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

[–] [email protected] 5 points 9 months ago (1 children)

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

[–] [email protected] 3 points 9 months 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.

[–] [email protected] 1 points 9 months ago

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

Same with asciimath (are they related? )