Updated: May 01, 2022
Choosing Markup Language¶
From my experience contributing to ILUGC website 1, I come know that Hugo 2 uses
Markdown which is the most popular modern markup language in internet right now. I don’t know why but I was hesitant to go with
Markdown, I searched what are the options we have. So, here are some ways to generate static html pages,
I’m not going to compare them, because I don’t know the benefits/drawbacks of each and everyone. So, I’m just giving what I felt when I tried few.
Popular format used in everywhere. Very simple to write, literally every static site generator support
Markdown. But cross referencing is pain, syntex highlighting is lacking compared to other systems, adding caption to an image is not available and there are few more drawbacks people say in internet 6.
Not as popular as
Markdownand not as easy as
Markdown. but we can pickup easily. One of the amazing thing is to add codes and do syntex highlighting. I use lot of syntex highlighting in my blog articles. So, when I tried
reStructuredTextI immediately fell in love for this one amazing functionality. No wonder why
reStructuredTextis used by python 7, kernel 8 organizations for documentation.
For a blog, having a RSS 11 feed is very important so that people who are interested in our blog will be able to get updates. Thankfully,
Sphinx already have extension to generate an
RSS feed file called yasfb 12,
so I simply used yasfb and integrated the output into by sidebar.