4 ms·

Anything that doesn't force you to remember arbitrary ordering - square brackets first? Or parentheses? It's the textual equivalent of plugging in usb upside do

• setopt 9mo ago
  > An alternative would be to simply use square brackets for both clauses of the link. For comparison, Org-mode uses [[LINK][DESCRIPTION]] instead of [DESCRIPTION](LINK).
  • evnp 9mo ago
    This is great! Not an emacs user (as yet) but this and org-mode's /italic/ _underline_ *bold* +strike+ feel that much closer to the oft-touted "source looks kinda like formatting” ideal of markdown. Not sure why we ended up with the mediocre version as a defacto standard.
    • macintux 9mo ago
      The only keyboard shortcut for org-mode and markdown-mode I consistently remember is C-c C-l for inserting links. Much easier to remember that than to remember the syntax, and the fact that both modes use the same easy-to-remember shortcut is a major win.
      • setopt 9mo ago
        Sadly, most other keybindings differ between org-mode, markdown-node, and auctex. I would have loved more consistency, and often end up typing the syntax instead of tripping up keybindings.
• simonkagedal 9mo ago
  Someone (maybe on this site) suggested to think of the bottom bars of the square brackets around the linked text to kind of frame the underline. Somehow worked really well for me, haven’t forgotten the syntax since.
  • evnp 9mo ago
    I like this, thank you.
• dpark 9mo ago
  I think it’s a natural outgrowth of the way links are commonly provided in plaintext, like so much other markdown. > The details can be found at my website (https://example.com https://example.com). The problem with this is that if you want to render this “pretty”, there’s no way to know whether the link should be “my website” or “website” or even the whole sentence. So you add brackets to clarify. > The details can be found at [my website](https://example.com https://example.com). There are certainly alternatives but I don’t think any of them are more natural, or memorable for that matter.
  • evnp 9mo ago
    My issue is remembering that the square brackets come first, not the parentheses. I do like asciidoc's method: https://example.com https://example.com for bare link, or https://example.com[pretty https://example.com[pretty text] if alternate text is desired Edit: It took me a re-read to fully understand your comment, I can see how square brackets might be an incremental addition. This may also help remember the syntax, thanks!
    • dpark 9mo ago
      That asciidoc format also seems very reasonable. The big issue isn’t specifically that markdown is wrong or right but that all these different systems are very inconsistent.
    • chrismorgan 9mo ago
      Excerpt from my notes when I was deciding on a link syntax for my own lightweight markup language: AsciiDoc doesn’t actually have a real link syntax—what it has is more or less an natural consequence of other syntax choices, but isn’t actually URL-aware, and will mangle some less common URLs. Still, what you get is mostly this kind of thing: • https://example.com[Link https://example.com[Link text] • link:URL[Link text] But woe betide you if you go beyond what it supports, its techniques when you need escaping are grotesque, monstrous horrors. Seriously, when you fall off the happy path, AsciiDoc is awful.