News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by jwilk on Tuesday March 15, 2016 @05:58PM (#11293336)
Is it [text](URL) or [URL](text) or (text)[URL] or...? It's impossible to remember, because this syntax is bizarre.
Re:Don’t Use Markdown for Documentation by UnoriginalGuy on Tuesday March 15, 2016 @06:37PM (#11293557)
I too get them back to front, but to be frank I have no better suggestion. Markdown definitely isn't perfect, but it is "good enough." Now if Only HN supported Markdown :)
Re:Don’t Use Markdown for Documentation by r3bl on Tuesday March 15, 2016 @06:59PM (#11293707)
Why do you think it is bizarre? I find [text](URL) pretty simple to remember.

On the other hand, creating a clickable image:

    [![alt-text](URL)](url)
...is way too complicated than it should be. In fact, I'm not sure if I wrote the syntax correctly right now.

I'll never understand why clickable images are not the standard way the image renders once you type in:

    ![alt-text](url)