4 ms·
Markdown is actually awful. There's at least 3 different dialects that are all called Markdown, so if you want your text rendered it's a toss-up as to whether o
by _ofdw 5y ago
Markdown is actually awful. There's at least 3 different dialects that are all called Markdown, so if you want your text rendered it's a toss-up as to whether or not it'll look how you intend.
I think that Markdown's success is due to a lack of a widely-used, simple alternative that's well-specified.
Org is easily and objectively the best markup but of course it's only very very recently that there was a non-emacs implement worth a damn.
- Seirdy 5y agoThen pick a standardized dialect. Commonmark is the lowest common denominator; GFM is useful for when you need some extra features. Markdown also allows HTML for whenever you need something fancy. The advantage of markdown isn't robustness, it's simplicity. Preteens can get a handle on it in minutes when using Reddit. The main benefit that all these markup-shorthands serve IMO is getting people to add meaning semantically rather than with presentation. Word processor users typically adjust font size and color to make headings, even when given a list of headings right in the ribbon. Markdown is just an HTML shorthand: you can only work with semantic meaning.
- na85 5y ago>Markdown also allows HTML for whenever you need something fancy. Indeed and therein lies what I view is Markdown's worst feature.
- Groxx 5y agoWhile I broadly agree, particularly because it feels so fuzzy about when it starts interpreting it as raw HTML and when it goes back to markdown... I'm not sure how you can really claim Org is unambiguously better (best!) when Org mode has multiple flavors of almost exactly the same kind of feature. E.g. inline HTML in Org is: https://orgmode.org/manual/Quoting-HTML-tags.html#Quoting-HTML-tags https://orgmode.org/manual/Quoting-HTML-tags.html#Quoting-HT... @@html:<b>@@bold text@@html:</b>@@ Or inline LaTeX, which is arguably much worse than markdown's HTML fuzziness: https://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments https://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragme... >To avoid conflicts with currency specifications, single ‘$’ characters are only recognized as math delimiters if the enclosed text contains at most two line breaks, is directly attached to the ‘$’ characters with no whitespace in between, and if the closing ‘$’ is followed by whitespace, punctuation or a dash. If I understand that correctly, it means this is LaTeX: $a^2 +1 =b$ But this is not: $a^2 +1 +2 =b$ Similarly, this is apparently an inline chunk of LaTeX: https://travel.stackexchange.com/questions/39527/which-countries-suffix-their-currency-and-how-much-is-this-stuck-to#comment72309_39530 https://travel.stackexchange.com/questions/39527/which-count... USA tends to use $123 to show dollar amounts, but e.g. Germany apparently sometimes uses 123$.
- tdhz77 5y agoMost of these differences are managed rather easy.
- approxim8ion 5y agoI get that Markdown is expected to be rendered into HTML eventually, but I find the syntax useful in its raw form too, just for formatting text files.
- ubermonkey 5y ago>Org is easily and objectively the best markup I laughed.