{"id":10922,"date":"2022-11-02T13:06:44","date_gmt":"2022-11-02T17:06:44","guid":{"rendered":"https:\/\/irreal.org\/blog\/?p=10922"},"modified":"2022-11-02T13:06:44","modified_gmt":"2022-11-02T17:06:44","slug":"a-discussion-of-markup-languages","status":"publish","type":"post","link":"https:\/\/irreal.org\/blog\/?p=10922","title":{"rendered":"A Discussion of Markup Languages"},"content":{"rendered":"<p>Alex Kladov has a post that <a href=\"https:\/\/matklad.github.io\/2022\/10\/28\/elements-of-a-great-markup-language.html\">discusses various markup languages and what makes a great one<\/a>. He considers<\/p>\n<ul class=\"org-ul\">\n<li>Markdown<\/li>\n<li>AsciiDoctor<\/li>\n<li>LaTeX<\/li>\n<li>reStructuredText<\/li>\n<li>HTML<\/li>\n<\/ul>\n<p>He finds them all lacking in various ways. He believes that any markup that\u2019s tied to a particular target language\u2014he puts Markdown is this category, unfairly I think\u2014is already losing. He believes that the parsing (and syntax) of the input language should be decoupled from the target language and the driver that produces it.<\/p>\n<p>If you look at the above list, you\u2019ll notice a glaring omission: Org mode is missing. That\u2019s too bad because Org meets most of the criteria that Kladov calls out. It\u2019s got a simple, lightweight syntax; it\u2019s tree structured; and has a simple format for links, lists, and tables. Perhaps most importantly for Kladov, Org mode markup syntax is not tied to any particular target language. Indeed, there are several targets and new ones are being added all the time. Even with a given target language, Org mode is flexible and extensible. You can mark some text as belonging to a particular environment with the name of your choice and define the semantic meaning of the environment with CSS or a LaTeX environment who definition you can include in a couple of ways. See <a href=\"https:\/\/irreal.org\/blog\/?p=10201\">this post<\/a> for details.<\/p>\n<p>Of course, ports notwithstanding, Org is mostly tied to Emacs. Much of the simplicity of writing in Org is because of shortcuts built into Emacs. Regardless, if you want the best and most flexible markup language, you should be using Org. Karl Voit makes a strong case that <a href=\"https:\/\/irreal.org\/blog\/?p=6627\">Org is the superior markup language<\/a> and I certainly agree. It would have been interesting to see Kladov\u2019s take.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Alex Kladov has a post that discusses various markup languages and what makes a great one. He considers Markdown AsciiDoctor LaTeX reStructuredText HTML He finds them all lacking in various ways. He believes that any markup that\u2019s tied to a &hellip; <a href=\"https:\/\/irreal.org\/blog\/?p=10922\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[18,4],"class_list":["post-10922","post","type-post","status-publish","format-standard","hentry","category-general","tag-emacs","tag-org-mode"],"_links":{"self":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10922","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10922"}],"version-history":[{"count":1,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10922\/revisions"}],"predecessor-version":[{"id":10923,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/10922\/revisions\/10923"}],"wp:attachment":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10922"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10922"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10922"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}