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.

@mikegerwitz Seems to me that it ought to be a SMOP to automatically do this -- find inline URL references and rewrite these as end-of-paragraph referenced links.

Programming is often a simpler, more effective, and ultimately a less traumatic alternative to Massive Social Reeducation Campaigns.

@dredmorbius That may be, but having to run a script to clean up Markdown partly defeats the purpose of using Markdown to begin with. It also introduces a different type of problem: having people who may be non-technical writers run such a script. They may be writing the Markdown on the web, on their desktop, on a mobile device, or in any number of environments.

My suggestion was just editorial advice that anyone can apply regardless of technical know-how.
Sign in to participate in the conversation

Generalistic and moderated instance.