4 ms·
I find much of the criticism against ("the") Markdown opinion-based. For instance, I hardly can remember whether it is `[http://example.com](foo)` http://exampl
by ktpsns 9y ago
I find much of the criticism against ("the") Markdown opinion-based. For instance, I hardly can remember whether it is `[http://example.com](foo)` http://example.com](foo)` or `(http://example.com)[foo]` http://example.com)[foo]` in Markdown but I would also confuse `[[http://example.com][foo]]` http://example.com][foo]]` with `[foo][http://example.com]]` http://example.com]]`.
In the same spirit, one may like or hate `*` for indicating headings (the choice is really unnatural for me, always thinking of a list).
- __john 9y agoThe way I remember [] before () is that [] is "basic" and square and () is "refined" and curvy. Seems silly but it helps me.
- lancefisher 9y agoI remember “brackets come before parentheses” alphabetically ;)
- 52-6F-62 9y agoThese are both helpful mnemonic tricks. I always forget links' syntax. More generally in this post I find Markdown has a pretty short learning curve, is highly readable and logical (EG. I like the number of `#` for level of headings). My biggest issue with Markdown is the different interpretations and how they're represented. Eg. Github vs. someplace else vs. Markdown-viewer apps. Org in comparison looks more concise, but less readable, IMO.
- Terretta 9y ago"squared circle" = []() https://en.wikipedia.org/wiki/Squaring_the_circle https://en.wikipedia.org/wiki/Squaring_the_circle
- accordionclown 9y agoi can't remember who i heard it from first, but "squaring the circle" is the phrase that (finally!) helped me remember the order after years of having to look it up every single time i needed it. i still have to look up the format for images every time.
- captaincrisp 9y agoI always sort of read it to myself. I use parens within normal writing as an aside (for example, this one), so I put the part that you read within the brackets and the reference in the parens. In plaintext you'd have a claim (and parens directing you to see the citation at citation.com). In hypertext you'd have a [claim](and a link to citation.com).
- kaushalmodi 9y agoThe way to remember that is that the link is important. For example, [[www.example.com]] makes sense.. it will render as www.example.com that hyperlinks to that link. But [[link description]] is useless by itself. So.. put the more important thing first, the link: [[www.example.com]] Now, if you also have a description text for that link, put that afterwards.. [[www.example.com][link description]] Hope that helps.
- vidarh 9y agoOften the link description is the most important thing, and may make sense without the link, so I'm not sure how well that would work. To me putting the link first is extremely counter-intuitive, as if writing plain text I'd also be more likely to write out a description of what I'm referencing first, and then enclosing the link in parentheses. Thankfully with Markdown that makes it easier to remember - the URL part is as it always was, and I just need to mark which part of the text makes up the description.
- Moyamo 9y agoIn html the link comes first <a href="link">Link Text</a>. So I would bet that most people are more comfortable with the link coming first.
- Jaxan 9y agoI'd argue that if you are writing text, you'll put the description first and then look up the link. Because the description is often part of the sentence, and the link is not.
- masklinn 9y agoIn fact you may write the entire thing first then look for whatever can or should be hyperlinked.
- vidarh 9y agoMost people wouldn't be able to explain to you what a HTML tag is, much less write one. And the entire point of Markdown is to get something that is closer to how we write plain text.
- chc4 9y agoI struggled with it, until I learned about "reference style" links in the original Markdown spec: this is a link [1] [1]: <link> would display 1 and direct you to <link>. Then inline links are just reference links but you have the location in parenthesis after the link body, as an aside.
- lloeki 9y agoThe reference style is my mnemonic to the order as well as where the parentheses are for non-reference links: since the reference definition uses []: then the reference uses [] too, and since the reference comes naturally after the text, then a non-ref link has the URL in not-[], hence (), and after the text too. IOW I just think about "inlining" the reference, which would have otherwise used [] everywhere. Feels much more regular that way around.
- deleted 9y ago[deleted]
- Jaxan 9y agoTo me, markdown and org-mode look completely equivalent. Surely there are small differences, which have to be learnt. Either way you have to remember some small details.
- deltaprotocol 9y agoIn org you don't need to remember. You just `C-c C-l` and it interactively asks for a link. You can type it or paste the link from your clipboard. _Then_ it asks you for an optional description. The same command works if you want to edit a link under the cursor. Also, most people have `C-c l` bound to a function that “captures” the link from wherever you are in Emacs (e.g. a newsfeed, a document, an email, a folder) so you can easily reference those places from within Org.
- vanderZwan 9y agoI think we should either compare these languages in a plain text editing context, or when used with editors with support for the syntax. Anything else seems like an unfair comparison to me. Because editors with MD support tend to have shortcuts for inserting a link or image too, so this isn't really an argument in favour of either syntax.
- deltaprotocol 9y agoI agree with you. My intention was to perhaps highlight one of the ways that using Emacs can help someone be productive using markup (but as you pointed this is probably true of other editors with strong support for the language) and maybe help someone discover an important feature of the editor that they have missed.
- kevinpet 9y ago"Most people" :) Fraction of people who have Emacs installed. Fraction of people who use Emacs for things other than programming. Fraction of those who use org-mode.
- deltaprotocol 9y agoWell, "most people" in the context of my comment was exactly that small fraction. You really thought that I was talking about the entire world? As an Emacs user I know most of humanity is far from ignumitation. (And also have bad sense of humor)
- defanor 9y agoAs mostly an org user, I still find that part of the markdown syntax to be more intuitive: parentheses are commonly used to clarify or expand on something, and links are often inserted with the same purpose, so a link goes into parentheses. E.g., "foo (you can find it there)".