Earlier quoted context omitted.
I recently tried to create markdown like parser, I had to refer a lot to common marks. What I saw was madness. I never knew from casual use, that markdown is so complex. There is literally zero thought about parsing, it forces natural looking text into a format that can be structured into actual markup, but it has so many pitfalls and edge cases that it just feels wrong. Each time I've looked up another markdown pars…
> If you need an AST to parse something seemingly simple like markdown, then something went wrong. This may surprise you, but that is very common in programming languages.
Why are we still using Markdown?
281–290 of 328 posts
Re: Why are we still using Markdown?
#282> These 2 produce IDENTICAL output. This is my single biggest complaint about reStructuredText. You create headings by putting underlines and (optional!) overlines around the section heading text. But all of the following are valid title adornment characters: ! " # $ % & ' ( ) \* + , - . / : ; ? @ [ \ ] ^ _ ` { | } ~ So in each doc you have to figure out the H1, H2, H3 formatting separately. E.g. in one doc it's: ==…
Re: Why are we still using Markdown?
#283https://djot.net/ seems to be very sane and still very similar to markdown. And after reading the CommonMark spec, I appreciate the saneness very much. CommonMark did a great job at describing all the rules and edge cases, but it clearly shows how messy markdown is. What do you all think of Djot?
- Djot requires
- writing nested lists
- with blank lines in between
- successive list items at the same level
- can skip the blank line
- but not this list item
Yes, supporting indented list items without blank lines in between would make Djot’s parser more complicated. But I write nested lists all the time in my notes, and extra blank lines would distract from the content. For me, it’s not worth it to make my raw text ugly just to make the file easier to parse.Djot could have avoided the blank line requirement by not trying to join hard-wrapped lines back into one paragraph / list item. That would work for me because I only soft wrap my text. Djot’s choice to support hard wrapping caused all of its users (including those who hard wrap) to have worse nested list syntax.
Re: Why are we still using Markdown?
#284Re: Why are we still using Markdown?
#285Earlier quoted context omitted.
So you can still see the actual text that you're editing. And to reduce ambiguity. If you don't leave them, then you can't distinguish between adding more bold text to currently bold text or adding non-bold text immediately after
> So you can still see the actual text that you're editing But you're not editing that text! You're editing some other text and see a bunch of asterisks all over the place. And this is especially bad in nested styles - try some colored bold word in a table cell - without hiding the markup you'll basically lose most of visibility into the text/table layout > to reduce ambiguity it does the opposite, you can't easily d…
This might be why I also liked LaTeX. The markup itself is semantic and meant to help me understand what I am editing. It isn't just some keyboard-shortcut to inject a styling command. It is part of the document structure.
Re: Why are we still using Markdown?
#286Earlier quoted context omitted.
On this planet, humans have read HTML without parsing for years. People building their first websites without any significant technical knowledge stole HTML by reading the source of other sites and edited it by hand.
Oh, please . Don't insult everyone here by pretending you actually believe HTML is a human readable format like markdown. It was never designed for that and has never claimed that. What a rediculous thing to even say.
Re: Why are we still using Markdown?
#287Re: Why are we still using Markdown?
#288Re: Why are we still using Markdown?
#289Earlier quoted context omitted.
It's also worth remembering that markdown tried very hard to encode conventions that were already used in Usenet, email, and other text media. A > to indicate a quote was widespread Usenet convention. Asterisks or underscores to indicate emphasis was also a common convention; both are legal because both were common. Double asterisk or double underscores to indicate really, really emphasizing something was also a comm…
markdown tried very hard to encode conventions that were already used in Usenet, email, and other text media For those of you who weren't there: *bold* _underline_ ~strikethrough~ /italics/ > Quotation - list - list - list I've been using these for almost half a century. They're much easier and more intuitive than Markdown. I see no compelling reason to change.