On the contrary, more and more repos are using RST recently.
For me this is the superior format, but alas, almost no one uses it. Even Python projects usually go with.md docs.
What new projects have you seen using.rst docs?
How Markdown took over the world
221–230 of 353 posts
Re: How Markdown took over the world
#222for me, the idea of structuring and formatting texts keyboard-only was fundamental for my adoption of markdown. iA Writer as an app that pushed me in that direction. Markdown, iA Writer, and my Keychron are part of my routine.
Re: How Markdown took over the world
#223Sound write-up. It is missing the #1 reason I like it though - it's fundamentally text. No format/vendor lock-in and very amenable to living in a git repo. For my note taking that's already game over right there against everything else. I don't want to worry about whatever cursed format OneNote uses is still something I can extract in 2035. I also like that it's become a defacto standard that LLMs speak. I can tell i…
> It is missing the #1 reason I like it though - it's fundamentally text.
Sure, but that's table stakes.
There are much better formats: AsciiDoc, reStructuredText, etc. Yet I also primarily use Markdown. I could use a format that's perhaps 20% better, and well-specified. But I'd have to use Markdown somewhere anyway. So I just stick with Markdown. It's good enough for me.
Re: How Markdown took over the world
#224Earlier quoted context omitted.
As I was griping above, you usually can't just view a Markdown file with formatting applied at all. I think MAYBE Notepad has been updated just recently to render it, but otherwise... you're looking at plain text with a bunch of formatting characters in it. Why? It's baffling. Where are the simple Markdown READERS?
Your plain text editor is the markdown reader. That’s the point.
and it looks like poo, that’s the other point
Re: How Markdown took over the world
#225Earlier quoted context omitted.
That would require Markdown to be standardized. (There is the CommonMark standard, but it’s extremely complex and still ambiguous.)
You could still support a subset of the most common features like bold, italic, strike, bullets, links, etc. Isn’t the beauty of MD supposed to be that if you can’t render it it should still look fine as plaintext?
The problem for web browsers is that markdown is technically a superset of HTML.
Re: How Markdown took over the world
#226Sorry, I'm going to be a downer. I've been around for a long time too, saw many formats come and go (even contributed to some myself). I think Markdown is super neat and handy, but this statement "The trillion-dollar AI industry's system for controlling their most advanced platforms is a plain text format... Their achievement is every bit as impressive as yours." ..is way off. NN math & engineering has been refined for ~50 years (give or take) and scaled to mindboggling levels. For better or worse, it is in the process of transforming how society functions (just like the internet and mobile phones did).
Building modern advanced NN/AI requires extremely sophisticated and advanced science, hardware & algorithms; the format of the prompts conventionally used by some are a handy but fairly trivial part of the endeavor.
Re: How Markdown took over the world
#227Markdown got there first/early depending on your perspective. Things like AsciiDoc got popular much later when AsciiDoctor was released around 2009 (though it technically existed already when Markdown was created) and is aimed at people who care about structured documentation. It's not aimed at casual users.
Likewise, things like org mode, which also emerged around the same time, catered to a niche of emacs using people. Which almost by definition is a subset of techies. It wasn't a logical choice for a mainstream blogging tool.
Markdown was aimed at people that used blogging tools (initially), and later any other kind of tool that accepted text. It spreading to tools like Slack, Github, etc. is no accident. Github actually has supported plenty of alternatives for documents. But they picked markdown for issue tracking, pull requests, etc. Because they had to just pick something and Markdown was the most popular.
By the time AsciiDoc became more popular (2009ish), Github was already being developed. With Markdown support. AsciiDoc was a niche thing, Markdown was already somewhat widely used then. It was an obvious choice. Them picking Markdown was important because the whole OSS community started using Github and got exposed to Markdown that way.
The rest is history. Other formats existed (textile, and various other wiki formats). They have features that are important to some people. But getting people to switch who don't really care about those features is hard. It's a bit like VHS over Betamax. Was it better. Not really. But it was there and video rental shops had to pick a format. And that wasn't Betamax when the dust settled.
Re: How Markdown took over the world
#228Sound write-up. It is missing the #1 reason I like it though - it's fundamentally text. No format/vendor lock-in and very amenable to living in a git repo. For my note taking that's already game over right there against everything else. I don't want to worry about whatever cursed format OneNote uses is still something I can extract in 2035. I also like that it's become a defacto standard that LLMs speak. I can tell i…
So is HTML and XML and bbcode...
The question is more why Markdown is slowly but surely outcompeting them.
Re: How Markdown took over the world
#229Earlier quoted context omitted.
A more intuitive norm, used in other formats, would have been : *bold* /italics/ _underline_
That's exactly what we used in on usenet (except,without rendering unless you were using a nice GUI reader, not just tin/rtin) The problem is that that's too many characters to reserve (they all have to be escaped when you want the actual character) making the resulting text look awful in plain text mode.
[deleted]
Re: How Markdown took over the world
#230The writeup does not mention Jeff Atwood (Stackoverflow founder) trying to convince Gruber to standardize markdown. Atwood approached him publicly in a series of blog posts, but Gruber kept silent, and if I remember correctly finally declined stating that he didn't want to spend time jumping through other persons' hoops. Although it sucks that markdown is not standardized, I still see this as an inspiring example of a person just doing what he wants to do.