You are viewing a single thread.
View all comments
30 points
*

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

permalink
report
reply
1 point

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

Same with asciimath (are they related? )

permalink
report
parent
reply
5 points

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

permalink
report
parent
reply
3 points

Unfortunately there’s no way to have a generated TOC within the page itself. It’s usually in a sidebar or something like that.

permalink
report
parent
reply

Programmer Humor

!programmer_humor@programming.dev

Create post

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

Community stats

  • 3.7K

    Monthly active users

  • 1.1K

    Posts

  • 39K

    Comments