If I could offer some advice to people who use #Markdown to write posts:

Many people use Markdown not just because the formatting is convenient to write, but also because it is itself human-readable. Consequently, it's also used as a plain text alternative to e.g. HTML-rendered text. I read a lot of things in plain text, so I see plain Markdown frequently.

One of the worst things you can do for legibility is to place URLs inline---it obscures the text, especially if there's a lot of them. Instead, use a reference (ideally numeric), of the form "[foo][n]".

Then, rather than placing all URLs at the bottom of the document, please them below the paragraph that references them. Not only does this reduce scrolling, but it also allows easily copying/pasting portions of the text while keeping the references intact, which is especially convenient for quoting.
@publicvoit I forgot to reply within the context of my original post:

While I prefer Org mode's markup, I still think that Markdown's is more clear as plain text for casual readers when it comes to references, for a couple of reasons:

- Links are of the form [[link][desc]] in Org mode---the link comes _before_ the text. When reading text, one expects a citation to come after the text. So [foo][5] in Markdown is more natural.
- Using numeric references for links isn't supported by default. Named links are (which is preferable when I use it for organization, but not necessarily as plain text), but you need a '#+LINK' line. Org mode looks great if you're viewing it in Emacs or viewing HTML output, but viewing it as plain text is a bit more ugly.

Admittedly, any time I see plain text Org mode, it's within Emacs and so is beautified. For example, even if I get an email with an Org mode fragment, Gnus formats it using org-mode.

Of course, Org mode shines at so many other things when compared to Markdown.

@mikegerwitz Interesting notion on the URL part.
However, there is also the rationale that I'd like to get the URL first and the description (what can be expected behind the URL when I visit the page) afterwards as a brief "summary". Both are legit, IMHO.

Sign in to participate in the conversation

Server run by the main developers of the project 🐘 It is not focused on any particular niche interest - everyone is welcome as long as you follow our code of conduct!