Hacker News Reader

Comment by alanh | Hacker News Reader

Which markdown? :-P

Some markdowns have some nice features:

- Fenced code blocks, which I would prefer to prefixing with colons (update: oh I guess org-mode has an equivalent! good)

- Footnote support

- Definition list support (<dl><dt></dt><dd></dd></dl>)

Additionally, it should be noted that Markdown allows usage of any HTML you want and it will be passed through. In practice this is often sanitized or escaped, but not always. On GitHub, for example, you are perfectly free to use <sup>, <detail><summary>, and so on.

Update Nice, Org-Mode does all that? Then that is a strong advantage over Markdown, where you never know which parts of which flavor will work on what site. (Heck, we can’t even get GitHub and StackOverflow to treat code blocks similarly.)

View on HN

org-mode has all the features you mentioned. Following gives you fenced code blocks:

  #+begin_src c
  printf("%d", 1);
  #+end_src

it has both named and unnamed footnotes [1]. You can use '::' in a list item to create a description list, like so:

  + coffee :: a dark, bitter, stimulating beverage
  + tea :: a beverage with effects similar to but milder than coffee
  + beer :: an alcoholic drink made from grains

[1]: http://orgmode.org/manual/Footnotes.html

```...``` is about ten times easier to write and twice as readable as #+begin_tok ... #+end_tok.

It does look easier, but in practice one edits org-mode docs in Emacs so typing the three keystrokes s<[Tab] at the beginning of a line produces:

    #+BEGIN_SRC 

    #+END_SRC

The cursor is left at the end of the first line where one presumably types the word python or c or shell or whatever language you'd like the code block to be treated as.

Once editing the code block, typing C-' takes you to a dedicated editing pane that runs in an emacs major mode most appropriate for the language being edited, with full Emacs programming language support. It's really painless, other than learning Emacs first, (LOL, but honestly really worth it).

Easier to write, yes, but only outside of emacs (and anything with good snippet support). Within emacs, <s TAB expands to

  #+BEGIN_SRC |
  
  #+END_SRC

with the cursor placed to specify a language.

As for readability, I don't think it's clear at all that ```...``` beats

  #+BEGIN_SRC perl
  ...
  #+END_SRC

* * *

As it turns out, I hadn't refreshed the page for hours, and someone else said pretty much the same five hours before.

Org mode handles footnotes:

    some text [fn:1]

    [fn:1] this is where the footnote text goes

The one thing that I find weird is that if you convert to HTML using pandoc, those appear after an <hr>, but in the org mode itself, they'll appear as children of the previous sub-heading.

Reply on news.ycombinator.com